@intellectif/lk-core 0.4.0 → 0.5.0

package/dist/schemas.d.ts

@@ -1,460 +1,3 @@
-import { e as ActivityType, t as ValidationResult, a as ActivityDataMap } from './activity-wkzRemHx.js';
-import { z } from 'zod/v4';
-
-/**
- * Optional authored "overall feedback" shown after submission, selected by
- * whether the learner passed (h5p-style overall feedback). Both fields are
- * optional; non-empty when present.
- */
-declare const FeedbackSchema: z.ZodObject<{
-    correct: z.ZodOptional<z.ZodString>;
-    incorrect: z.ZodOptional<z.ZodString>;
-}, z.core.$loose>;
-
-/**
- * Zod schema for a `TextMatchPolicy` — the opt-in matching tolerances a blank
- * may declare. Every default reproduces the v1 trim + case-fold semantics.
- */
-declare const TextMatchPolicySchema: z.ZodObject<{
-    caseSensitive: z.ZodOptional<z.ZodBoolean>;
-    trim: z.ZodOptional<z.ZodBoolean>;
-    normalize: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        NFC: "NFC";
-        NFKC: "NFKC";
-    }>>;
-    foldDiacritics: z.ZodOptional<z.ZodBoolean>;
-    collapseInnerWhitespace: z.ZodOptional<z.ZodBoolean>;
-    ignorePunctuation: z.ZodOptional<z.ZodBoolean>;
-    levenshtein: z.ZodOptional<z.ZodNumber>;
-    locale: z.ZodOptional<z.ZodString>;
-}, z.core.$loose>;
-/**
- * Zod schema for a single fill-in-the-blank slot configuration. Loose:
- * unknown keys are preserved through validation. Accepted answers must
- * contain non-whitespace characters — a whitespace-only accepted answer
- * normalizes to the empty string and would mark an empty response correct.
- */
-declare const BlankConfigSchema: z.ZodObject<{
-    id: z.ZodString;
-    acceptedAnswers: z.ZodArray<z.ZodString>;
-    caseSensitive: z.ZodOptional<z.ZodBoolean>;
-    trimWhitespace: z.ZodOptional<z.ZodBoolean>;
-    match: z.ZodOptional<z.ZodObject<{
-        caseSensitive: z.ZodOptional<z.ZodBoolean>;
-        trim: z.ZodOptional<z.ZodBoolean>;
-        normalize: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            NFC: "NFC";
-            NFKC: "NFKC";
-        }>>;
-        foldDiacritics: z.ZodOptional<z.ZodBoolean>;
-        collapseInnerWhitespace: z.ZodOptional<z.ZodBoolean>;
-        ignorePunctuation: z.ZodOptional<z.ZodBoolean>;
-        levenshtein: z.ZodOptional<z.ZodNumber>;
-        locale: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>;
-    hint: z.ZodOptional<z.ZodString>;
-    feedback: z.ZodOptional<z.ZodString>;
-}, z.core.$loose>;
-/**
- * Zod schema validating the full Fill-in-the-Blanks activity data contract.
- * Loose at every level: unknown keys are preserved, never stripped (B7).
- *
- * The refinement enforces a true one-to-one correspondence between `{{id}}`
- * placeholders and `blanks[].id`: every blank id appears EXACTLY ONCE in the
- * passage and exactly once in `blanks[]`. (The previous set-based check let
- * duplicate placeholders and duplicate blank configs through, corrupting the
- * partial-score denominator and per-item details.)
- */
-declare const FillInTheBlanksDataSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<"1.0">;
-    type: z.ZodLiteral<"fill-in-the-blanks">;
-    id: z.ZodString;
-    title: z.ZodString;
-    passage: z.ZodString;
-    passageHtml: z.ZodOptional<z.ZodString>;
-    blanks: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        acceptedAnswers: z.ZodArray<z.ZodString>;
-        caseSensitive: z.ZodOptional<z.ZodBoolean>;
-        trimWhitespace: z.ZodOptional<z.ZodBoolean>;
-        match: z.ZodOptional<z.ZodObject<{
-            caseSensitive: z.ZodOptional<z.ZodBoolean>;
-            trim: z.ZodOptional<z.ZodBoolean>;
-            normalize: z.ZodOptional<z.ZodEnum<{
-                none: "none";
-                NFC: "NFC";
-                NFKC: "NFKC";
-            }>>;
-            foldDiacritics: z.ZodOptional<z.ZodBoolean>;
-            collapseInnerWhitespace: z.ZodOptional<z.ZodBoolean>;
-            ignorePunctuation: z.ZodOptional<z.ZodBoolean>;
-            levenshtein: z.ZodOptional<z.ZodNumber>;
-            locale: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>;
-        hint: z.ZodOptional<z.ZodString>;
-        feedback: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>;
-    scoringStrategy: z.ZodEnum<{
-        "all-or-nothing": "all-or-nothing";
-        partial: "partial";
-    }>;
-    media: z.ZodOptional<z.ZodObject<{
-        type: z.ZodEnum<{
-            image: "image";
-            audio: "audio";
-            video: "video";
-            embed: "embed";
-        }>;
-        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
-        alt: z.ZodOptional<z.ZodString>;
-        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-    }, z.core.$loose>>;
-    feedback: z.ZodOptional<z.ZodObject<{
-        correct: z.ZodOptional<z.ZodString>;
-        incorrect: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>;
-    passThreshold: z.ZodOptional<z.ZodNumber>;
-    locale: z.ZodOptional<z.ZodString>;
-    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
-}, z.core.$loose>;
-
-/**
- * JSON Schema (Draft 7) representation of the Multiple Choice activity data
- * contract, generated natively by Zod 4. Draft 7 is mandated by Requirement
- * 2.2 for the widest AI-prompt / OpenAPI tooling compatibility. The semantic
- * `.refine()` guards are not representable in JSON Schema and are
- * intentionally omitted — the export captures the *structural* contract only.
- * Since v0.3 the source schemas are loose, so these no longer emit
- * `additionalProperties: false` — the JSON Schema and `validateActivity` now
- * agree on unknown-key handling.
- */
-declare const multipleChoiceJsonSchema: z.core.JSONSchema.JSONSchema;
-/**
- * JSON Schema (Draft 7) representation of the Fill-in-the-Blanks activity data
- * contract, generated natively by Zod 4. Structural contract only (semantic
- * `.refine()` guards are Zod-only and not representable in JSON Schema).
- */
-declare const fillInTheBlanksJsonSchema: z.core.JSONSchema.JSONSchema;
-/**
- * JSON Schema (Draft 7) representation of the Written Response activity data
- * contract. Structural contract only.
- */
-declare const writtenResponseJsonSchema: z.core.JSONSchema.JSONSchema;
-/**
- * Derives the JSON Schema (Draft 7) for any REGISTERED activity type — the
- * live, registry-backed replacement for the static per-type exports above,
- * and the building block for AI generation pipelines (R6.1): pass the result
- * as a structured-output schema so a model can only emit valid items.
- *
- * @throws UnknownActivityTypeError when `type` has no registered descriptor.
- */
-declare function jsonSchemaFor(type: string): Record<string, unknown>;
-
-/**
- * Optional media attached to an activity, rendered above the question or
- * passage — e.g. a recording to listen to, or an embedded video to watch
- * before answering. URL-only by design: hosting/delivery (S3/CDN, or the
- * provider's own embed for `embed`) is the consuming app's responsibility
- * (see requirements "Non-Goals and Shared Responsibility").
- *
- * - `image`: rendered as `<img>` — `alt` is REQUIRED (WCAG 1.1.1 / Req 14.5).
- * - `audio` / `video`: rendered with native controls; `alt` is an optional
- *   accessible label; `captionsUrl` points at a WebVTT `<track>`. `url` must
- *   be a direct media file (NOT a YouTube/Vimeo page — use `embed` for those).
- * - `embed`: rendered as a sandboxed `<iframe>` for provider players
- *   (YouTube/Vimeo/etc.). `url` MUST be the provider's *embeddable* URL
- *   (e.g. `https://www.youtube.com/embed/<id>`). `alt` is REQUIRED and used
- *   as the iframe's accessible `title` (WCAG 4.1.2 / 2.4.1).
- */
-/**
- * Media URL policy (security-reviewed): absolute URLs must use `https:`,
- * `http:`, `data:`, or `blob:`; root-relative paths (`/media/x.mp3`) are
- * allowed for same-origin hosting. Everything else — notably `javascript:`,
- * `file:`, `ftp:` — is rejected: these URLs land in `src` attributes
- * (including an iframe for `embed`), so an unvetted scheme is a stored-XSS
- * vector in every consuming app.
- */
-declare const MediaUrlSchema: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
-declare const MediaSchema: 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]>>;
-}, z.core.$loose>;
-
-/**
- * Zod schema for a single Multiple Choice option. Loose: unknown keys are
- * preserved through validation (forward-compat / consumer sidecars — B7).
- */
-declare const MultipleChoiceOptionSchema: z.ZodObject<{
-    id: z.ZodString;
-    text: z.ZodString;
-    isCorrect: z.ZodBoolean;
-    feedback: z.ZodOptional<z.ZodString>;
-}, z.core.$loose>;
-/**
- * Zod schema validating the full Multiple Choice activity data contract.
- * Loose at every level: unknown keys are preserved, never stripped, so a
- * v0.3 runtime reading a future payload (or a consumer sidecar field) does
- * not silently delete data.
- *
- * Semantic guards: (1) at least one option must be correct, otherwise the
- * activity can never be answered correctly; (2) `mode: 'single'` must have
- * exactly one correct option — multiple correct options under single-select
- * make `showCorrectAnswers` and the xAPI correct-response ambiguous and mask
- * authoring errors; (3) option ids must be unique — the scorer looks options
- * up by id, so a duplicate id makes one option unscoreable. All are
- * unrepresentable in JSON Schema and are dropped from `toJSONSchema` output
- * by design.
- */
-declare const MultipleChoiceDataSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<"1.0">;
-    type: z.ZodLiteral<"multiple-choice">;
-    id: z.ZodString;
-    title: z.ZodString;
-    question: z.ZodString;
-    questionHtml: z.ZodOptional<z.ZodString>;
-    mode: z.ZodEnum<{
-        single: "single";
-        multi: "multi";
-    }>;
-    options: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        text: z.ZodString;
-        isCorrect: z.ZodBoolean;
-        feedback: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>;
-    scoringStrategy: z.ZodEnum<{
-        "all-or-nothing": "all-or-nothing";
-        partial: "partial";
-    }>;
-    media: z.ZodOptional<z.ZodObject<{
-        type: z.ZodEnum<{
-            image: "image";
-            audio: "audio";
-            video: "video";
-            embed: "embed";
-        }>;
-        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
-        alt: z.ZodOptional<z.ZodString>;
-        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-    }, z.core.$loose>>;
-    feedback: z.ZodOptional<z.ZodObject<{
-        correct: z.ZodOptional<z.ZodString>;
-        incorrect: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>;
-    passThreshold: z.ZodOptional<z.ZodNumber>;
-    shuffle: z.ZodOptional<z.ZodBoolean>;
-    locale: z.ZodOptional<z.ZodString>;
-    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
-}, z.core.$loose>;
-
-/** A redacted Multiple Choice option: id and display text only — no `isCorrect`, no feedback. */
-declare const RedactedMultipleChoiceOptionSchema: z.ZodObject<{
-    id: z.ZodString;
-    text: z.ZodString;
-}, z.core.$strict>;
-/**
- * Redacted Multiple Choice data: renderable (question, mode, options to pick
- * from) with the answer key, per-option feedback, overall feedback, and the
- * scoring strategy removed. `scoringStrategy` is answer-key by design: MC
- * `partial` carries a wrong-selection penalty `all-or-nothing` does not, so
- * knowing the strategy tells a learner whether guessing is free.
- */
-declare const RedactedMultipleChoiceDataSchema: z.ZodObject<{
-    type: z.ZodLiteral<"multiple-choice">;
-    question: z.ZodString;
-    questionHtml: z.ZodOptional<z.ZodString>;
-    mode: z.ZodEnum<{
-        single: "single";
-        multi: "multi";
-    }>;
-    options: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        text: z.ZodString;
-    }, z.core.$strict>>;
-    shuffle: z.ZodOptional<z.ZodBoolean>;
-    /** Marker distinguishing a redacted projection from full activity data. */
-    redacted: z.ZodLiteral<true>;
-    schemaVersion: z.ZodLiteral<"1.0">;
-    id: z.ZodString;
-    title: z.ZodString;
-    media: z.ZodOptional<z.ZodObject<{
-        type: z.ZodEnum<{
-            image: "image";
-            audio: "audio";
-            video: "video";
-            embed: "embed";
-        }>;
-        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
-        alt: z.ZodOptional<z.ZodString>;
-        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-    }, z.core.$loose>>;
-    passThreshold: z.ZodOptional<z.ZodNumber>;
-    locale: z.ZodOptional<z.ZodString>;
-    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
-}, z.core.$strict>;
-/** A redacted blank: id and hint only — no accepted answers, no matching rules, no feedback. */
-declare const RedactedBlankConfigSchema: z.ZodObject<{
-    id: z.ZodString;
-    hint: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-/** Redacted Fill-in-the-Blanks data: passage and blank slots, key removed. */
-declare const RedactedFillInTheBlanksDataSchema: z.ZodObject<{
-    type: z.ZodLiteral<"fill-in-the-blanks">;
-    passage: z.ZodString;
-    passageHtml: z.ZodOptional<z.ZodString>;
-    blanks: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        hint: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-    /** Marker distinguishing a redacted projection from full activity data. */
-    redacted: z.ZodLiteral<true>;
-    schemaVersion: z.ZodLiteral<"1.0">;
-    id: z.ZodString;
-    title: z.ZodString;
-    media: z.ZodOptional<z.ZodObject<{
-        type: z.ZodEnum<{
-            image: "image";
-            audio: "audio";
-            video: "video";
-            embed: "embed";
-        }>;
-        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
-        alt: z.ZodOptional<z.ZodString>;
-        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-    }, z.core.$loose>>;
-    passThreshold: z.ZodOptional<z.ZodNumber>;
-    locale: z.ZodOptional<z.ZodString>;
-    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
-}, z.core.$strict>;
-/**
- * Redacted Written Response data: the prompt, word bounds and rubric are
- * learner-visible (a rubric tells the learner what they are graded on);
- * authored pass/fail feedback is removed until the grade exists.
- */
-declare const RedactedWrittenResponseDataSchema: z.ZodObject<{
-    type: z.ZodLiteral<"written-response">;
-    prompt: z.ZodString;
-    promptHtml: z.ZodOptional<z.ZodString>;
-    minWords: z.ZodNumber;
-    maxWords: z.ZodNumber;
-    rubric: z.ZodOptional<z.ZodObject<{
-        label: z.ZodOptional<z.ZodString>;
-        criteria: z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-            weight: z.ZodNumber;
-        }, z.core.$loose>>;
-    }, z.core.$loose>>;
-    languageTarget: z.ZodOptional<z.ZodString>;
-    /** Marker distinguishing a redacted projection from full activity data. */
-    redacted: z.ZodLiteral<true>;
-    schemaVersion: z.ZodLiteral<"1.0">;
-    id: z.ZodString;
-    title: z.ZodString;
-    media: z.ZodOptional<z.ZodObject<{
-        type: z.ZodEnum<{
-            image: "image";
-            audio: "audio";
-            video: "video";
-            embed: "embed";
-        }>;
-        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
-        alt: z.ZodOptional<z.ZodString>;
-        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-    }, z.core.$loose>>;
-    passThreshold: z.ZodOptional<z.ZodNumber>;
-    locale: z.ZodOptional<z.ZodString>;
-    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
-}, z.core.$strict>;
-
-/** Zod schema for a single rubric criterion. Loose: unknown keys preserved. */
-declare const WrittenResponseRubricCriterionSchema: z.ZodObject<{
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    weight: z.ZodNumber;
-}, z.core.$loose>;
-/** Zod schema for a written-response grading rubric. Loose: unknown keys preserved. */
-declare const WrittenResponseRubricSchema: z.ZodObject<{
-    label: z.ZodOptional<z.ZodString>;
-    criteria: z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-        weight: z.ZodNumber;
-    }, z.core.$loose>>;
-}, z.core.$loose>;
-/**
- * Zod schema validating the Written Response activity data contract (Req 22).
- *
- * Wire-format constraints (Req 22.9): field names are locked for
- * byte-compatibility with consumer-stored rows, and the schema is loose at
- * EVERY level (Req 22.5) — unknown top-level keys, `promptHtml`, `rubric`
- * sidecars and any future fields survive `validateActivity` verbatim.
- */
-declare const WrittenResponseDataSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<"1.0">;
-    type: z.ZodLiteral<"written-response">;
-    id: z.ZodString;
-    title: z.ZodString;
-    prompt: z.ZodString;
-    promptHtml: z.ZodOptional<z.ZodString>;
-    minWords: z.ZodNumber;
-    maxWords: z.ZodNumber;
-    rubric: z.ZodOptional<z.ZodObject<{
-        label: z.ZodOptional<z.ZodString>;
-        criteria: z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-            weight: z.ZodNumber;
-        }, z.core.$loose>>;
-    }, z.core.$loose>>;
-    languageTarget: z.ZodOptional<z.ZodString>;
-    media: z.ZodOptional<z.ZodObject<{
-        type: z.ZodEnum<{
-            image: "image";
-            audio: "audio";
-            video: "video";
-            embed: "embed";
-        }>;
-        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
-        alt: z.ZodOptional<z.ZodString>;
-        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-    }, z.core.$loose>>;
-    feedback: z.ZodOptional<z.ZodObject<{
-        correct: z.ZodOptional<z.ZodString>;
-        incorrect: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>;
-    passThreshold: z.ZodOptional<z.ZodNumber>;
-    locale: z.ZodOptional<z.ZodString>;
-    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
-}, z.core.$loose>;
-
-/**
- * Validates raw activity data against the schema registered for the given
- * activity type (built-in or consumer-registered via `registerActivityType`).
- *
- * Unknown keys are PRESERVED, not stripped: every built-in schema is loose,
- * so consumer sidecar fields and forward-version fields survive validation
- * verbatim in the returned `data`.
- *
- * @returns `{ success: true, data }` with the typed, validated data, or
- *          `{ success: false, errors }` with one entry per failed constraint.
- * @throws UnknownActivityTypeError when `type` has no registered descriptor.
- */
-declare function validateActivity<T extends ActivityType>(type: T, data: unknown): ValidationResult<ActivityDataMap[T]>;
-
-export { BlankConfigSchema, FeedbackSchema, FillInTheBlanksDataSchema, MediaSchema, MediaUrlSchema, MultipleChoiceDataSchema, MultipleChoiceOptionSchema, RedactedBlankConfigSchema, RedactedFillInTheBlanksDataSchema, RedactedMultipleChoiceDataSchema, RedactedMultipleChoiceOptionSchema, RedactedWrittenResponseDataSchema, TextMatchPolicySchema, WrittenResponseDataSchema, WrittenResponseRubricCriterionSchema, WrittenResponseRubricSchema, fillInTheBlanksJsonSchema, jsonSchemaFor, multipleChoiceJsonSchema, validateActivity, writtenResponseJsonSchema };
+import './activity-wkzRemHx.js';
+export { B as BlankConfigSchema, F as FeedbackSchema, a as FillInTheBlanksDataSchema, b as ItemGroupSchema, M as MediaSchema, c as MediaUrlSchema, d as MultipleChoiceDataSchema, e as MultipleChoiceOptionSchema, R as RedactedBlankConfigSchema, f as RedactedFillInTheBlanksDataSchema, g as RedactedItemGroupSchema, h as RedactedMultipleChoiceDataSchema, i as RedactedMultipleChoiceOptionSchema, j as RedactedStimulusSchema, k as RedactedWrittenResponseDataSchema, p as StimulusSchema, T as TextMatchPolicySchema, W as WrittenResponseDataSchema, q as WrittenResponseRubricCriterionSchema, r as WrittenResponseRubricSchema, s as fillInTheBlanksJsonSchema, t as itemGroupJsonSchema, u as jsonSchemaFor, v as multipleChoiceJsonSchema, w as stimulusJsonSchema, x as validateActivity, y as validateItemGroup, z as writtenResponseJsonSchema } from './index-CLmXzBhB.js';
+import 'zod/v4';

package/dist/schemas.js

@@ -1,10 +1,17 @@
 import {
+  ItemGroupSchema,
+  RedactedItemGroupSchema,
+  RedactedStimulusSchema,
+  StimulusSchema,
   fillInTheBlanksJsonSchema,
+  itemGroupJsonSchema,
   jsonSchemaFor,
   multipleChoiceJsonSchema,
+  stimulusJsonSchema,
   validateActivity,
+  validateItemGroup,
   writtenResponseJsonSchema
-} from "./chunk-55O4M45K.js";
+} from "./chunk-LSHDNA2T.js";
 import {
   BlankConfigSchema,
   FeedbackSchema,
@@ -22,29 +29,35 @@ import {
   WrittenResponseDataSchema,
   WrittenResponseRubricCriterionSchema,
   WrittenResponseRubricSchema
-} from "./chunk-5GJJHGY5.js";
-import "./chunk-3YAVDV5F.js";
+} from "./chunk-NUCEUU4P.js";
 export {
   BlankConfigSchema,
   FeedbackSchema,
   FillInTheBlanksDataSchema,
+  ItemGroupSchema,
   MediaSchema,
   MediaUrlSchema,
   MultipleChoiceDataSchema,
   MultipleChoiceOptionSchema,
   RedactedBlankConfigSchema,
   RedactedFillInTheBlanksDataSchema,
+  RedactedItemGroupSchema,
   RedactedMultipleChoiceDataSchema,
   RedactedMultipleChoiceOptionSchema,
+  RedactedStimulusSchema,
   RedactedWrittenResponseDataSchema,
+  StimulusSchema,
   TextMatchPolicySchema,
   WrittenResponseDataSchema,
   WrittenResponseRubricCriterionSchema,
   WrittenResponseRubricSchema,
   fillInTheBlanksJsonSchema,
+  itemGroupJsonSchema,
   jsonSchemaFor,
   multipleChoiceJsonSchema,
+  stimulusJsonSchema,
   validateActivity,
+  validateItemGroup,
   writtenResponseJsonSchema
 };
 //# sourceMappingURL=schemas.js.map

package/dist/scoring.cjs

@@ -7,12 +7,11 @@
 
 
 
-var _chunk5ZAW76F3cjs = require('./chunk-5ZAW76F3.cjs');
+var _chunkSM5HUGYUcjs = require('./chunk-SM5HUGYU.cjs');
 
 
 
-var _chunkQOAORTA4cjs = require('./chunk-QOAORTA4.cjs');
-require('./chunk-PIMX4B4D.cjs');
+var _chunk4JR3UXX6cjs = require('./chunk-4JR3UXX6.cjs');
 
 
 
@@ -24,5 +23,5 @@ require('./chunk-PIMX4B4D.cjs');
 
 
 
-exports.DEFAULT_PASS_THRESHOLD = _chunk5ZAW76F3cjs.DEFAULT_PASS_THRESHOLD; exports.classifyBand = _chunk5ZAW76F3cjs.classifyBand; exports.composeAssessmentScore = _chunk5ZAW76F3cjs.composeAssessmentScore; exports.computePassThreshold = _chunk5ZAW76F3cjs.computePassThreshold; exports.evaluate = _chunk5ZAW76F3cjs.evaluate; exports.gte = _chunk5ZAW76F3cjs.gte; exports.levenshteinDistance = _chunkQOAORTA4cjs.levenshteinDistance; exports.matchText = _chunkQOAORTA4cjs.matchText; exports.roundGrade = _chunk5ZAW76F3cjs.roundGrade; exports.score = _chunk5ZAW76F3cjs.score;
+exports.DEFAULT_PASS_THRESHOLD = _chunkSM5HUGYUcjs.DEFAULT_PASS_THRESHOLD; exports.classifyBand = _chunkSM5HUGYUcjs.classifyBand; exports.composeAssessmentScore = _chunkSM5HUGYUcjs.composeAssessmentScore; exports.computePassThreshold = _chunkSM5HUGYUcjs.computePassThreshold; exports.evaluate = _chunkSM5HUGYUcjs.evaluate; exports.gte = _chunkSM5HUGYUcjs.gte; exports.levenshteinDistance = _chunk4JR3UXX6cjs.levenshteinDistance; exports.matchText = _chunk4JR3UXX6cjs.matchText; exports.roundGrade = _chunkSM5HUGYUcjs.roundGrade; exports.score = _chunkSM5HUGYUcjs.score;
 //# sourceMappingURL=scoring.cjs.map

package/dist/scoring.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/scoring.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yjBAAC","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/scoring.cjs"}
+{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/scoring.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yjBAAC","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/scoring.cjs"}

package/dist/scoring.d.cts

@@ -193,8 +193,16 @@ declare const DEFAULT_PASS_THRESHOLD = 0.7;
 /**
  * Returns `true` iff `score` meets or exceeds the activity's `passThreshold`,
  * defaulting to {@link DEFAULT_PASS_THRESHOLD} (0.7) when the field is absent.
+ *
+ * Pass a {@link RoundingPolicy} to compare the way an assessment total is
+ * compared — both sides rounded, via {@link gte} — so an item shown as "70%"
+ * cannot be recorded as a fail at 69.6. It is **opt-in** rather than the
+ * default because switching it on changes item-level pass/fail for scores in
+ * the rounding band, and this SDK does not alter historical grades without an
+ * explicit decision. Absent, the comparison is the exact raw `>=` it has
+ * always been.
  */
-declare function computePassThreshold(activityData: ActivityData, score: number): boolean;
+declare function computePassThreshold(activityData: ActivityData, score: number, rounding?: RoundingPolicy): boolean;
 /**
  * Scores a learner response against activity data and returns a full
  * {@link ScoringResult}.

package/dist/scoring.d.ts

@@ -193,8 +193,16 @@ declare const DEFAULT_PASS_THRESHOLD = 0.7;
 /**
  * Returns `true` iff `score` meets or exceeds the activity's `passThreshold`,
  * defaulting to {@link DEFAULT_PASS_THRESHOLD} (0.7) when the field is absent.
+ *
+ * Pass a {@link RoundingPolicy} to compare the way an assessment total is
+ * compared — both sides rounded, via {@link gte} — so an item shown as "70%"
+ * cannot be recorded as a fail at 69.6. It is **opt-in** rather than the
+ * default because switching it on changes item-level pass/fail for scores in
+ * the rounding band, and this SDK does not alter historical grades without an
+ * explicit decision. Absent, the comparison is the exact raw `>=` it has
+ * always been.
  */
-declare function computePassThreshold(activityData: ActivityData, score: number): boolean;
+declare function computePassThreshold(activityData: ActivityData, score: number, rounding?: RoundingPolicy): boolean;
 /**
  * Scores a learner response against activity data and returns a full
  * {@link ScoringResult}.

package/dist/scoring.js

@@ -7,12 +7,11 @@ import {
   gte,
   roundGrade,
   score
-} from "./chunk-A6JXV5GP.js";
+} from "./chunk-DUQVGLQ3.js";
 import {
   levenshteinDistance,
   matchText
-} from "./chunk-5GJJHGY5.js";
-import "./chunk-3YAVDV5F.js";
+} from "./chunk-NUCEUU4P.js";
 export {
   DEFAULT_PASS_THRESHOLD,
   classifyBand,

package/dist/xapi.cjs

@@ -3,12 +3,14 @@
 
 
 
-var _chunkRUZ52Q7Acjs = require('./chunk-RUZ52Q7A.cjs');
-require('./chunk-PIMX4B4D.cjs');
 
+var _chunkR7PDJBRXcjs = require('./chunk-R7PDJBRX.cjs');
+require('./chunk-4JR3UXX6.cjs');
 
 
 
 
-exports.XAPIVerb = _chunkRUZ52Q7Acjs.XAPIVerb; exports.XAPI_VERB_DISPLAY = _chunkRUZ52Q7Acjs.XAPI_VERB_DISPLAY; exports.validateXAPIStatement = _chunkRUZ52Q7Acjs.validateXAPIStatement; exports.xAPIBuilder = _chunkRUZ52Q7Acjs.xAPIBuilder;
+
+
+exports.XAPIVerb = _chunkR7PDJBRXcjs.XAPIVerb; exports.XAPI_VERB_DISPLAY = _chunkR7PDJBRXcjs.XAPI_VERB_DISPLAY; exports.validateXAPIStatement = _chunkR7PDJBRXcjs.validateXAPIStatement; exports.xAPIBuilder = _chunkR7PDJBRXcjs.xAPIBuilder; exports.xapiDefinitionFor = _chunkR7PDJBRXcjs.xapiDefinitionFor;
 //# sourceMappingURL=xapi.cjs.map

package/dist/xapi.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/xapi.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACF,6OAAC","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/xapi.cjs"}
+{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/xapi.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACF,8SAAC","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/xapi.cjs"}

package/dist/xapi.d.cts

@@ -114,6 +114,23 @@ declare const xAPIBuilder: {
     buildSubmittedStatement(params: SubmittedStatementParams): XAPIStatement;
     buildCompletedStatement(params: CompletedStatementParams): XAPIStatement;
 };
+/**
+ * Builds the xAPI `object.definition` interop fields for an activity from its
+ * REGISTERED descriptor, rather than having every renderer hand-roll them.
+ *
+ * `ActivityTypeDescriptor.interop` declares the activity-type IRI, the
+ * cmi.interaction type and how to derive `correctResponsesPattern`; before
+ * this, those fields had no reader anywhere and each component rebuilt the
+ * same strings inline — the same "declared but never used" defect the SDK
+ * fixed elsewhere. Reading them here also means a consumer-registered type
+ * gets correct interop for free.
+ *
+ * Returns an empty object for an unregistered type or one that declares no
+ * interop, so it is always safe to spread.
+ */
+declare function xapiDefinitionFor(data: {
+    type: string;
+}): Partial<XAPIObjectParams>;
 
 /**
  * Validates a constructed {@link XAPIStatement} against the xAPI 1.0.3
@@ -130,4 +147,4 @@ declare const xAPIBuilder: {
  */
 declare function validateXAPIStatement(statement: XAPIStatement): void;
 
-export { type AnsweredStatementParams, type CompletedStatementParams, type SubmittedStatementParams, type XAPIObjectParams, type XAPIStatementParams, XAPIVerb, type XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder };
+export { type AnsweredStatementParams, type CompletedStatementParams, type SubmittedStatementParams, type XAPIObjectParams, type XAPIStatementParams, XAPIVerb, type XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor };