@intellectif/lk-core 0.2.1 → 0.3.0

package/dist/activity-D5tqgx8A.d.ts

@@ -1,330 +0,0 @@
-/**
- * An xAPI Activity object — the thing a statement is about.
- * This SDK only builds Activity-type objects (xAPI 1.0.3 §4.1.4.1).
- */
-interface XAPIObject {
-    objectType: 'Activity';
-    /** IRI uniquely identifying the activity. */
-    id: string;
-    definition?: {
-        /** Language-map of human-readable names for the activity. */
-        name?: Record<string, string>;
-        /** Language-map of human-readable descriptions. */
-        description?: Record<string, string>;
-        /** IRI identifying the activity type. */
-        type?: string;
-        extensions?: Record<string, unknown>;
-    };
-}
-/**
- * An xAPI Agent (person or system) that performed the statement's verb.
- * Exactly one of `mbox` or `account` must be present.
- */
-interface XAPIActor {
-    objectType: 'Agent';
-    /** Display name for the actor. */
-    name?: string;
-    /** Mailto IRI uniquely identifying the actor (e.g. `mailto:user@example.com`). */
-    mbox?: string;
-    /** Account-based actor identifier. */
-    account?: {
-        /** IRI of the home page of the account's service provider. */
-        homePage: string;
-        /** The actor's unique name on that service. */
-        name: string;
-    };
-}
-/** An xAPI Verb — the action performed in the statement. */
-interface XAPIVerbObject {
-    /** IRI uniquely identifying this verb (e.g. from adlnet.gov/expapi/verbs). */
-    id: string;
-    /** Language-map of human-readable verb labels. */
-    display: Record<string, string>;
-}
-/** Score sub-object within an xAPI Result. */
-interface XAPIScore {
-    /** Normalized score in the range [0, 1]. */
-    scaled: number;
-    /** Raw score in the instrument's native scale. */
-    raw?: number;
-    /** Minimum possible raw score. */
-    min?: number;
-    /** Maximum possible raw score. */
-    max?: number;
-}
-/** Result information attached to an xAPI Statement. */
-interface XAPIResult {
-    score?: XAPIScore;
-    /** Whether the actor's performance was successful. */
-    success?: boolean;
-    /** Whether the activity was completed. */
-    completion?: boolean;
-    /** ISO 8601 duration string representing time spent (e.g. `PT5M30S`). */
-    duration?: string;
-    /** A string representation of the learner's response. */
-    response?: string;
-    extensions?: Record<string, unknown>;
-}
-/** Context information attached to an xAPI Statement. */
-interface XAPIContext {
-    /** Name of the software used to record the statement. */
-    platform?: string;
-    /** BCP 47 language tag for the activity content. */
-    language?: string;
-    extensions?: Record<string, unknown>;
-}
-/** A complete xAPI 1.0.3 Statement. */
-interface XAPIStatement {
-    /** UUID v4 uniquely identifying this statement. */
-    id: string;
-    actor: XAPIActor;
-    verb: XAPIVerbObject;
-    object: XAPIObject;
-    result?: XAPIResult;
-    context?: XAPIContext;
-    /** ISO 8601 timestamp of when the statement occurred. */
-    timestamp: string;
-    version: '1.0.3';
-}
-/**
- * Configuration passed to `useXAPI` to connect to an LRS endpoint.
- * The `auth` field supports both HTTP Basic and Bearer token authentication.
- */
-interface XAPIConfig {
-    /** Full URL of the LRS statements endpoint. */
-    endpoint: string;
-    /** Authentication credentials for the LRS. */
-    auth: {
-        type: 'basic';
-        username: string;
-        password: string;
-    } | {
-        type: 'bearer';
-        token: string;
-    };
-    /** IRI identifying the activity in all statements sent by this hook instance. */
-    activityId: string;
-    actor: XAPIActor;
-    /** Called after all retry attempts are exhausted. */
-    onError?: (err: XAPIError) => void;
-}
-/** Error payload delivered to `XAPIConfig.onError` after retries are exhausted. */
-interface XAPIError {
-    /** The statement that failed to send. */
-    statement: XAPIStatement;
-    /** The 1-based attempt number on which the final failure occurred. */
-    attempt: number;
-    /** HTTP status code from the LRS, if a response was received. */
-    statusCode?: number;
-    /** Human-readable error description. */
-    message: string;
-}
-
-/** The set of activity types supported by learning-kit. */
-type ActivityType = 'multiple-choice' | 'fill-in-the-blanks';
-/** Maps each ActivityType string to its corresponding data shape. */
-interface ActivityDataMap {
-    'multiple-choice': MultipleChoiceData;
-    'fill-in-the-blanks': FillInTheBlanksData;
-}
-/** Union of all valid activity data shapes. */
-type ActivityData = MultipleChoiceData | FillInTheBlanksData;
-/**
- * Optional media (image/audio/video) shown above a question or passage.
- * URL-only: hosting/delivery is the consuming application's responsibility.
- */
-interface ActivityMedia {
-    /** The kind of media; selects the rendered element. `embed` → sandboxed iframe. */
-    type: 'image' | 'audio' | 'video' | 'embed';
-    /**
-     * Source URL. For `embed` this MUST be the provider's embeddable URL
-     * (e.g. `https://www.youtube.com/embed/<id>`), not the watch page.
-     */
-    url: string;
-    /** Alternative text. Required for `image` and `embed`; optional label for audio/video. */
-    alt?: string;
-    /** Optional WebVTT captions track URL for `audio`/`video`. */
-    captionsUrl?: string;
-}
-/**
- * Optional authored "overall feedback" shown after submission, chosen by
- * whether the learner passed (h5p-style overall feedback). Distinct from
- * per-option feedback; either field may be omitted.
- */
-interface ActivityFeedback {
-    /** Shown when the learner passes (score ≥ pass threshold). */
-    correct?: string;
-    /** Shown when the learner does not pass. */
-    incorrect?: string;
-}
-/** A single selectable option within a Multiple Choice activity. */
-interface MultipleChoiceOption {
-    /** Unique identifier for this option within the activity. */
-    id: string;
-    /** Display text shown to the learner. */
-    text: string;
-    /** Whether this option is part of the correct answer. */
-    isCorrect: boolean;
-    /** Optional per-option feedback shown after submission. */
-    feedback?: string;
-}
-/** Data contract for a Multiple Choice activity. */
-interface MultipleChoiceData {
-    schemaVersion: '1.0';
-    type: 'multiple-choice';
-    /** Unique identifier for this activity. */
-    id: string;
-    /** Human-readable title used in xAPI statements and error boundaries. */
-    title: string;
-    /** The question stem presented to the learner. */
-    question: string;
-    /** `single` allows one selection; `multi` allows multiple. */
-    mode: 'single' | 'multi';
-    /** Ordered list of answer options. */
-    options: MultipleChoiceOption[];
-    /** Scoring algorithm applied when the learner submits. */
-    scoringStrategy: 'all-or-nothing' | 'partial';
-    /** Optional media shown above the question. */
-    media?: ActivityMedia;
-    /** Optional authored overall feedback shown after submission. */
-    feedback?: ActivityFeedback;
-    /** Minimum scaled score [0–1] required to pass. Defaults to 0.6 when absent. */
-    passThreshold?: number;
-    /** When true, options are shuffled deterministically per session. */
-    shuffle?: boolean;
-    /** 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;
-}
-/** Configuration for a single fill-in-the-blank slot. */
-interface BlankConfig {
-    /** Unique identifier matching the `{{blank_id}}` placeholder in the passage. */
-    id: string;
-    /** List of strings accepted as correct answers for this blank. */
-    acceptedAnswers: string[];
-    /** Whether answer matching is case-sensitive. Defaults to false. */
-    caseSensitive?: boolean;
-    /** Whether leading/trailing whitespace is stripped before matching. Defaults to true. */
-    trimWhitespace?: boolean;
-    /** Optional hint text revealed on learner request. */
-    hint?: string;
-    /** Optional feedback shown inline next to this blank after submission. */
-    feedback?: string;
-}
-/** Data contract for a Fill-in-the-Blanks activity. */
-interface FillInTheBlanksData {
-    schemaVersion: '1.0';
-    type: 'fill-in-the-blanks';
-    /** Unique identifier for this activity. */
-    id: string;
-    /** Human-readable title used in xAPI statements and error boundaries. */
-    title: string;
-    /** Passage text containing `{{blank_id}}` placeholders. */
-    passage: string;
-    /** Configuration for each blank in the passage. */
-    blanks: BlankConfig[];
-    /** Scoring algorithm applied when the learner submits. */
-    scoringStrategy: 'all-or-nothing' | 'partial';
-    /** 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 0.6 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;
-}
-/** Union of all learner response shapes. */
-type LearnerResponse = MultipleChoiceLearnerResponse | FillInTheBlanksLearnerResponse;
-/** Learner response for a Multiple Choice activity. */
-interface MultipleChoiceLearnerResponse {
-    type: 'multiple-choice';
-    /** IDs of the options the learner selected. */
-    selectedOptionIds: string[];
-}
-/** Learner response for a Fill-in-the-Blanks activity. */
-interface FillInTheBlanksLearnerResponse {
-    type: 'fill-in-the-blanks';
-    /** Map of blank ID to the learner's typed answer. */
-    answers: Record<string, string>;
-}
-/** Per-item scoring breakdown returned by the scoring engine. */
-interface ScoringDetail {
-    /** ID of the option or blank this detail refers to. */
-    itemId: string;
-    /** Whether the learner's response for this item was correct. */
-    correct: boolean;
-    /** The learner's actual response for this item. */
-    learnerResponse: string | string[];
-    /** The expected correct response(s) for this item. */
-    correctResponse: string | string[];
-    /** Optional weight applied to this item's contribution to the overall score. */
-    weight?: number;
-}
-/** Full scoring result returned by the scoring engine. */
-interface ScoringResult {
-    /** Scaled score in the range [0, 1]. */
-    score: number;
-    /** Maximum possible scaled score (always 1). */
-    maxScore: number;
-    /** Whether the score meets or exceeds the activity's pass threshold. */
-    passed: boolean;
-    /** Optional top-level feedback message, or null when absent. */
-    feedback: string | null;
-    /** Per-item scoring breakdown. */
-    details: ScoringDetail[];
-}
-/** A single validation error produced by `validateActivity`. */
-interface ValidationError {
-    /** JSON-path-style location of the invalid field. */
-    path: string[];
-    /** Human-readable description of the validation failure. */
-    message: string;
-    /** Machine-readable error code. */
-    code: string;
-}
-/**
- * Result of a `validateActivity` call.
- * On success, `data` is the validated and typed activity data.
- * On failure, `errors` contains one entry per violated constraint.
- */
-type ValidationResult<T> = {
-    success: true;
-    data: T;
-} | {
-    success: false;
-    errors: ValidationError[];
-};
-/** The payload delivered to an activity's `onComplete` callback. */
-interface ActivityResult {
-    /** Scaled score in the range [0, 1]. */
-    score: number;
-    /** Maximum possible scaled score (always 1). */
-    maxScore: number;
-    /** Whether the learner passed based on the activity's pass threshold. */
-    passed: boolean;
-    /** Time in milliseconds from first interaction to submission. */
-    timeSpent: number;
-    /** The xAPI statement built and (optionally) sent for this attempt. */
-    xapiStatement: XAPIStatement;
-}
-/** Fired by activity components on every discrete learner interaction. */
-interface InteractionEvent {
-    /** The kind of interaction that occurred. */
-    type: 'option-selected' | 'option-deselected' | 'blank-filled' | 'hint-requested' | 'submitted';
-    /** ID of the activity that produced the event. */
-    activityId: string;
-    /** Unix timestamp (ms) of when the interaction occurred. */
-    timestamp: number;
-    /** Additional event-specific data. */
-    payload: Record<string, unknown>;
-}
-
-export type { ActivityData as A, BlankConfig as B, FillInTheBlanksData as F, InteractionEvent as I, LearnerResponse as L, MultipleChoiceData as M, ScoringDetail as S, ValidationError as V, XAPIActor as X, ActivityDataMap as a, ActivityFeedback as b, ActivityMedia as c, ActivityResult as d, ActivityType as e, FillInTheBlanksLearnerResponse as f, MultipleChoiceLearnerResponse as g, MultipleChoiceOption as h, ScoringResult as i, ValidationResult as j, XAPIConfig as k, XAPIContext as l, XAPIError as m, XAPIObject as n, XAPIResult as o, XAPIScore as p, XAPIStatement as q, XAPIVerbObject as r };

package/dist/chunk-2T3IL7VL.js

@@ -1,147 +0,0 @@
-// src/schemas/fill-in-the-blanks.ts
-import { z as z3 } from "zod/v4";
-
-// src/schemas/feedback.ts
-import { z } from "zod/v4";
-var FeedbackSchema = z.object({
-  correct: z.string().min(1).optional(),
-  incorrect: z.string().min(1).optional()
-});
-
-// src/schemas/media.ts
-import { z as z2 } from "zod/v4";
-var MediaSchema = z2.object({
-  type: z2.enum(["image", "audio", "video", "embed"]),
-  url: z2.url(),
-  alt: z2.string().min(1).optional(),
-  captionsUrl: z2.url().optional()
-}).refine(
-  (m) => m.type !== "image" && m.type !== "embed" || typeof m.alt === "string" && m.alt.length > 0,
-  {
-    error: "image and embed media require non-empty alt text (WCAG 1.1.1 / 4.1.2).",
-    path: ["alt"]
-  }
-);
-
-// src/schemas/fill-in-the-blanks.ts
-var PLACEHOLDER_RE = /\{\{\s*([^{}]+?)\s*\}\}/g;
-var BlankConfigSchema = z3.object({
-  id: z3.string().min(1),
-  acceptedAnswers: z3.array(z3.string().min(1)).min(1),
-  caseSensitive: z3.boolean().optional(),
-  trimWhitespace: z3.boolean().optional(),
-  hint: z3.string().optional(),
-  feedback: z3.string().optional()
-});
-var FillInTheBlanksDataSchema = z3.object({
-  schemaVersion: z3.literal("1.0"),
-  type: z3.literal("fill-in-the-blanks"),
-  id: z3.string().min(1),
-  title: z3.string().min(1),
-  passage: z3.string().min(1),
-  blanks: z3.array(BlankConfigSchema).min(1),
-  scoringStrategy: z3.enum(["all-or-nothing", "partial"]),
-  media: MediaSchema.optional(),
-  feedback: FeedbackSchema.optional(),
-  passThreshold: z3.number().min(0).max(1).optional(),
-  locale: z3.string().optional(),
-  learningObjectives: z3.array(z3.string()).optional(),
-  difficultyLevel: z3.literal([1, 2, 3, 4, 5]).optional()
-}).refine(
-  (data) => {
-    const placeholderIds = new Set(
-      [...data.passage.matchAll(PLACEHOLDER_RE)].map((match) => match[1])
-    );
-    const blankIds = new Set(data.blanks.map((blank) => blank.id));
-    if (placeholderIds.size !== blankIds.size) {
-      return false;
-    }
-    for (const id of blankIds) {
-      if (!placeholderIds.has(id)) {
-        return false;
-      }
-    }
-    return true;
-  },
-  {
-    error: "Each blank id must have exactly one matching {{id}} placeholder in the passage, and vice versa.",
-    path: ["passage"]
-  }
-);
-
-// src/schemas/multiple-choice.ts
-import { z as z4 } from "zod/v4";
-var MultipleChoiceOptionSchema = z4.object({
-  id: z4.string().min(1),
-  text: z4.string().min(1),
-  isCorrect: z4.boolean(),
-  feedback: z4.string().optional()
-});
-var MultipleChoiceDataSchema = z4.object({
-  schemaVersion: z4.literal("1.0"),
-  type: z4.literal("multiple-choice"),
-  id: z4.string().min(1),
-  title: z4.string().min(1),
-  question: z4.string().min(1),
-  mode: z4.enum(["single", "multi"]),
-  options: z4.array(MultipleChoiceOptionSchema).min(2).max(10),
-  scoringStrategy: z4.enum(["all-or-nothing", "partial"]),
-  media: MediaSchema.optional(),
-  feedback: FeedbackSchema.optional(),
-  passThreshold: z4.number().min(0).max(1).optional(),
-  shuffle: z4.boolean().optional(),
-  locale: z4.string().optional(),
-  learningObjectives: z4.array(z4.string()).optional(),
-  difficultyLevel: z4.literal([1, 2, 3, 4, 5]).optional()
-}).refine((data) => data.options.some((option) => option.isCorrect), {
-  error: "At least one option must be marked correct.",
-  path: ["options"]
-}).refine(
-  (data) => data.mode !== "single" || data.options.filter((option) => option.isCorrect).length === 1,
-  {
-    error: 'Single-select activities (mode: "single") must have exactly one correct option.',
-    path: ["options"]
-  }
-);
-
-// src/schemas/json-schema.ts
-import { z as z5 } from "zod/v4";
-var multipleChoiceJsonSchema = z5.toJSONSchema(MultipleChoiceDataSchema, {
-  target: "draft-7"
-});
-var fillInTheBlanksJsonSchema = z5.toJSONSchema(FillInTheBlanksDataSchema, {
-  target: "draft-7"
-});
-
-// src/schemas/index.ts
-var schemaMap = {
-  "multiple-choice": MultipleChoiceDataSchema,
-  "fill-in-the-blanks": FillInTheBlanksDataSchema
-};
-function validateActivity(type, data) {
-  const result = schemaMap[type].safeParse(data);
-  if (result.success) {
-    return { success: true, data: result.data };
-  }
-  return {
-    success: false,
-    errors: result.error.issues.map((issue) => ({
-      path: issue.path.map(String),
-      message: issue.message,
-      code: issue.code
-    }))
-  };
-}
-
-export {
-  FeedbackSchema,
-  MediaSchema,
-  BlankConfigSchema,
-  FillInTheBlanksDataSchema,
-  MultipleChoiceOptionSchema,
-  MultipleChoiceDataSchema,
-  multipleChoiceJsonSchema,
-  fillInTheBlanksJsonSchema,
-  validateActivity
-};
-//# sourceMappingURL=chunk-2T3IL7VL.js.map

package/dist/chunk-2T3IL7VL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/schemas/fill-in-the-blanks.ts","../src/schemas/feedback.ts","../src/schemas/media.ts","../src/schemas/multiple-choice.ts","../src/schemas/json-schema.ts","../src/schemas/index.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport { FeedbackSchema } from './feedback.js';\nimport { MediaSchema } from './media.js';\n\n/** Matches `{{ blank_id }}` placeholders in a passage, capturing the trimmed id. */\nconst PLACEHOLDER_RE = /\\{\\{\\s*([^{}]+?)\\s*\\}\\}/g;\n\n/** Zod schema for a single fill-in-the-blank slot configuration. */\nexport const BlankConfigSchema = z.object({\n  id: z.string().min(1),\n  acceptedAnswers: z.array(z.string().min(1)).min(1),\n  caseSensitive: z.boolean().optional(),\n  trimWhitespace: z.boolean().optional(),\n  hint: z.string().optional(),\n  feedback: z.string().optional(),\n});\n\n/**\n * Zod schema validating the full Fill-in-the-Blanks activity data contract.\n *\n * The refinement enforces a bijection between `{{id}}` placeholders in the\n * passage and `blanks[].id`; otherwise a blank could never be rendered, or a\n * placeholder could have no scoring config, yielding undefined behaviour.\n */\nexport const FillInTheBlanksDataSchema = z\n  .object({\n    schemaVersion: z.literal('1.0'),\n    type: z.literal('fill-in-the-blanks'),\n    id: z.string().min(1),\n    title: z.string().min(1),\n    passage: z.string().min(1),\n    blanks: z.array(BlankConfigSchema).min(1),\n    scoringStrategy: z.enum(['all-or-nothing', 'partial']),\n    media: MediaSchema.optional(),\n    feedback: FeedbackSchema.optional(),\n    passThreshold: z.number().min(0).max(1).optional(),\n    locale: z.string().optional(),\n    learningObjectives: z.array(z.string()).optional(),\n    difficultyLevel: z.literal([1, 2, 3, 4, 5]).optional(),\n  })\n  .refine(\n    (data) => {\n      const placeholderIds = new Set(\n        [...data.passage.matchAll(PLACEHOLDER_RE)].map((match) => match[1]),\n      );\n      const blankIds = new Set(data.blanks.map((blank) => blank.id));\n      if (placeholderIds.size !== blankIds.size) {\n        return false;\n      }\n      for (const id of blankIds) {\n        if (!placeholderIds.has(id)) {\n          return false;\n        }\n      }\n      return true;\n    },\n    {\n      error:\n        'Each blank id must have exactly one matching {{id}} placeholder in the passage, and vice versa.',\n      path: ['passage'],\n    },\n  );\n","import { z } from 'zod/v4';\n\n/**\n * Optional authored \"overall feedback\" shown after submission, selected by\n * whether the learner passed (h5p-style overall feedback). Both fields are\n * optional; non-empty when present.\n */\nexport const FeedbackSchema = z.object({\n  correct: z.string().min(1).optional(),\n  incorrect: z.string().min(1).optional(),\n});\n","import { z } from 'zod/v4';\n\n/**\n * Optional media attached to an activity, rendered above the question or\n * passage — e.g. a recording to listen to, or an embedded video to watch\n * before answering. URL-only by design: hosting/delivery (S3/CDN, or the\n * provider's own embed for `embed`) is the consuming app's responsibility\n * (see requirements \"Non-Goals and Shared Responsibility\").\n *\n * - `image`: rendered as `<img>` — `alt` is REQUIRED (WCAG 1.1.1 / Req 14.5).\n * - `audio` / `video`: rendered with native controls; `alt` is an optional\n *   accessible label; `captionsUrl` points at a WebVTT `<track>`. `url` must\n *   be a direct media file (NOT a YouTube/Vimeo page — use `embed` for those).\n * - `embed`: rendered as a sandboxed `<iframe>` for provider players\n *   (YouTube/Vimeo/etc.). `url` MUST be the provider's *embeddable* URL\n *   (e.g. `https://www.youtube.com/embed/<id>`). `alt` is REQUIRED and used\n *   as the iframe's accessible `title` (WCAG 4.1.2 / 2.4.1).\n */\nexport const MediaSchema = z\n  .object({\n    type: z.enum(['image', 'audio', 'video', 'embed']),\n    url: z.url(),\n    alt: z.string().min(1).optional(),\n    captionsUrl: z.url().optional(),\n  })\n  .refine(\n    (m) =>\n      (m.type !== 'image' && m.type !== 'embed') || (typeof m.alt === 'string' && m.alt.length > 0),\n    {\n      error: 'image and embed media require non-empty alt text (WCAG 1.1.1 / 4.1.2).',\n      path: ['alt'],\n    },\n  );\n","import { z } from 'zod/v4';\nimport { FeedbackSchema } from './feedback.js';\nimport { MediaSchema } from './media.js';\n\n/** Zod schema for a single Multiple Choice option. */\nexport const MultipleChoiceOptionSchema = z.object({\n  id: z.string().min(1),\n  text: z.string().min(1),\n  isCorrect: z.boolean(),\n  feedback: z.string().optional(),\n});\n\n/**\n * Zod schema validating the full Multiple Choice activity data contract.\n *\n * Two semantic guards: (1) at least one option must be correct, otherwise the\n * activity can never be answered correctly; (2) `mode: 'single'` must have\n * exactly one correct option — multiple correct options under single-select\n * make `showCorrectAnswers` and the xAPI correct-response ambiguous and mask\n * authoring errors. Both are unrepresentable in JSON Schema and are dropped\n * from `toJSONSchema` output by design.\n */\nexport const MultipleChoiceDataSchema = z\n  .object({\n    schemaVersion: z.literal('1.0'),\n    type: z.literal('multiple-choice'),\n    id: z.string().min(1),\n    title: z.string().min(1),\n    question: z.string().min(1),\n    mode: z.enum(['single', 'multi']),\n    options: z.array(MultipleChoiceOptionSchema).min(2).max(10),\n    scoringStrategy: z.enum(['all-or-nothing', 'partial']),\n    media: MediaSchema.optional(),\n    feedback: FeedbackSchema.optional(),\n    passThreshold: z.number().min(0).max(1).optional(),\n    shuffle: z.boolean().optional(),\n    locale: z.string().optional(),\n    learningObjectives: z.array(z.string()).optional(),\n    difficultyLevel: z.literal([1, 2, 3, 4, 5]).optional(),\n  })\n  .refine((data) => data.options.some((option) => option.isCorrect), {\n    error: 'At least one option must be marked correct.',\n    path: ['options'],\n  })\n  .refine(\n    (data) =>\n      data.mode !== 'single' || data.options.filter((option) => option.isCorrect).length === 1,\n    {\n      error: 'Single-select activities (mode: \"single\") must have exactly one correct option.',\n      path: ['options'],\n    },\n  );\n","import { z } from 'zod/v4';\nimport { FillInTheBlanksDataSchema } from './fill-in-the-blanks.js';\nimport { MultipleChoiceDataSchema } from './multiple-choice.js';\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 */\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","import type { ActivityDataMap, ActivityType, ValidationResult } from '../types/activity.js';\nimport { FillInTheBlanksDataSchema } from './fill-in-the-blanks.js';\nimport { MultipleChoiceDataSchema } from './multiple-choice.js';\n\nexport { FeedbackSchema } from './feedback.js';\nexport { BlankConfigSchema, FillInTheBlanksDataSchema } from './fill-in-the-blanks.js';\nexport { fillInTheBlanksJsonSchema, multipleChoiceJsonSchema } from './json-schema.js';\nexport { MediaSchema } from './media.js';\nexport { MultipleChoiceDataSchema, MultipleChoiceOptionSchema } from './multiple-choice.js';\n\n/** Maps each activity type to the Zod schema that validates its data. */\nconst schemaMap = {\n  'multiple-choice': MultipleChoiceDataSchema,\n  'fill-in-the-blanks': FillInTheBlanksDataSchema,\n} as const;\n\n/**\n * Validates raw activity data against the schema for the given activity type.\n *\n * @returns `{ success: true, data }` with the typed, validated data, or\n *          `{ success: false, errors }` with one entry per failed constraint.\n */\nexport function validateActivity<T extends ActivityType>(\n  type: T,\n  data: unknown,\n): ValidationResult<ActivityDataMap[T]> {\n  const result = schemaMap[type].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"],"mappings":"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","names":["z","z","z","z","z","z","z"]}

package/dist/chunk-3JMLUUFS.cjs

@@ -1,124 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
-
-var _chunkDV466SBJcjs = require('./chunk-DV466SBJ.cjs');
-
-// src/scoring/strategies/all-or-nothing.ts
-function allOrNothingStrategy(correctItems) {
-  return correctItems.every((isCorrect) => isCorrect) ? 1 : 0;
-}
-
-// src/scoring/strategies/partial.ts
-function partialStrategy(correctSelected, incorrectSelected, totalCorrect, totalIncorrect) {
-  const reward = correctSelected / totalCorrect;
-  const penalty = totalIncorrect === 0 ? 0 : incorrectSelected / totalIncorrect;
-  return Math.max(0, reward - penalty);
-}
-function partialBlankStrategy(correctBlanks, totalBlanks) {
-  return correctBlanks / totalBlanks;
-}
-
-// src/scoring/activity-scorers/fill-in-the-blanks.ts
-function normalize(value, blank) {
-  let result = value;
-  if (blank.trimWhitespace !== false) {
-    result = result.trim();
-  }
-  if (blank.caseSensitive !== true) {
-    result = result.toLowerCase();
-  }
-  return result;
-}
-function scoreFillInTheBlanks(data, response) {
-  const details = [];
-  const perBlankCorrect = [];
-  for (const blank of data.blanks) {
-    const rawInput = response.answers[blank.id];
-    const input = typeof rawInput === "string" ? rawInput : "";
-    const normalizedInput = normalize(input, blank);
-    const matched = blank.acceptedAnswers.some(
-      (accepted) => normalize(accepted, blank) === normalizedInput
-    );
-    perBlankCorrect.push(matched);
-    details.push({
-      itemId: blank.id,
-      correct: matched,
-      learnerResponse: [input],
-      correctResponse: [...blank.acceptedAnswers]
-    });
-  }
-  const correctBlanks = perBlankCorrect.filter(Boolean).length;
-  const scoreValue = data.scoringStrategy === "all-or-nothing" ? allOrNothingStrategy(perBlankCorrect) : partialBlankStrategy(correctBlanks, data.blanks.length);
-  return { score: scoreValue, maxScore: 1, feedback: null, details };
-}
-
-// src/scoring/activity-scorers/multiple-choice.ts
-function scoreMultipleChoice(data, response) {
-  const optionById = new Map(data.options.map((option) => [option.id, option]));
-  const selected = new Set(response.selectedOptionIds);
-  const totalCorrect = data.options.filter((option) => option.isCorrect).length;
-  const totalIncorrect = data.options.length - totalCorrect;
-  let scoreValue;
-  if (data.scoringStrategy === "all-or-nothing") {
-    if (data.mode === "single") {
-      scoreValue = response.selectedOptionIds.length === 1 && _optionalChain([optionById, 'access', _ => _.get, 'call', _2 => _2(response.selectedOptionIds[0]), 'optionalAccess', _3 => _3.isCorrect]) === true ? 1 : 0;
-    } else {
-      const correctIds = data.options.filter((o) => o.isCorrect).map((o) => o.id);
-      const allCorrectSelected = correctIds.every((id) => selected.has(id));
-      scoreValue = selected.size === correctIds.length && allCorrectSelected ? 1 : 0;
-    }
-  } else {
-    let correctSelected = 0;
-    let incorrectSelected = 0;
-    for (const id of selected) {
-      const option = optionById.get(id);
-      if (_optionalChain([option, 'optionalAccess', _4 => _4.isCorrect])) {
-        correctSelected += 1;
-      } else {
-        incorrectSelected += 1;
-      }
-    }
-    scoreValue = partialStrategy(correctSelected, incorrectSelected, totalCorrect, totalIncorrect);
-  }
-  const details = data.options.map((option) => {
-    const wasSelected = selected.has(option.id);
-    return {
-      itemId: option.id,
-      correct: wasSelected === option.isCorrect,
-      learnerResponse: [wasSelected ? "selected" : "not-selected"],
-      correctResponse: [option.isCorrect ? "selected" : "not-selected"]
-    };
-  });
-  return { score: scoreValue, maxScore: 1, feedback: null, details };
-}
-
-// src/scoring/index.ts
-var DEFAULT_PASS_THRESHOLD = 0.7;
-function computePassThreshold(activityData, score2) {
-  return score2 >= (_nullishCoalesce(activityData.passThreshold, () => ( DEFAULT_PASS_THRESHOLD)));
-}
-function score(activityType, activityData, learnerResponse) {
-  let result;
-  switch (activityType) {
-    case "multiple-choice":
-      result = scoreMultipleChoice(
-        activityData,
-        learnerResponse
-      );
-      break;
-    case "fill-in-the-blanks":
-      result = scoreFillInTheBlanks(
-        activityData,
-        learnerResponse
-      );
-      break;
-    default:
-      throw new (0, _chunkDV466SBJcjs.UnknownActivityTypeError)(String(activityType));
-  }
-  return { ...result, passed: computePassThreshold(activityData, result.score) };
-}
-
-
-
-
-exports.computePassThreshold = computePassThreshold; exports.score = score;
-//# sourceMappingURL=chunk-3JMLUUFS.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/chunk-3JMLUUFS.cjs","../src/scoring/strategies/all-or-nothing.ts","../src/scoring/strategies/partial.ts","../src/scoring/activity-scorers/fill-in-the-blanks.ts","../src/scoring/activity-scorers/multiple-choice.ts","../src/scoring/index.ts"],"names":["score"],"mappings":"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","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/chunk-3JMLUUFS.cjs","sourcesContent":[null,"/**\n * All-or-nothing scoring: full credit only when every item is correct.\n *\n * @param correctItems - per-item correctness flags for the relevant items\n * @returns `1` if every item is correct (or the list is empty), otherwise `0`\n */\nexport function allOrNothingStrategy(correctItems: boolean[]): number {\n  return correctItems.every((isCorrect) => isCorrect) ? 1 : 0;\n}\n","/**\n * Partial-credit scoring for Multiple Choice — balanced/symmetric scheme.\n *\n * Reward and penalty are each normalised by their own pool: the fraction of\n * correct options found, minus the fraction of distractors wrongly chosen.\n * This is fairer than normalising the penalty by the correct-option count —\n * under that older form a single wrong pick could zero an otherwise-correct\n * response when there was only one correct answer.\n *\n * Result is always in [0, 1]: `reward ∈ [0,1]` and `penalty ∈ [0,1]`, so\n * `reward - penalty ∈ [-1,1]` and `max(0, …)` floors it at 0. Selecting every\n * option yields `1 - 1 = 0`; selecting exactly the correct set yields `1`.\n *\n * @param correctSelected - number of selected options that are correct\n * @param incorrectSelected - number of selected options that are incorrect\n * @param totalCorrect - total correct options; the `MultipleChoiceDataSchema`\n *   \"≥1 correct\" guard guarantees this is ≥ 1, so the reward term cannot\n *   divide by zero for schema-validated data\n * @param totalIncorrect - total incorrect options (distractors); when `0`\n *   (every option is correct) the penalty term is defined as `0`\n */\nexport function partialStrategy(\n  correctSelected: number,\n  incorrectSelected: number,\n  totalCorrect: number,\n  totalIncorrect: number,\n): number {\n  const reward = correctSelected / totalCorrect;\n  const penalty = totalIncorrect === 0 ? 0 : incorrectSelected / totalIncorrect;\n  return Math.max(0, reward - penalty);\n}\n\n/**\n * Partial-credit scoring for Fill-in-the-Blanks: fraction of blanks answered\n * correctly. Each blank is independently right or wrong, so a plain proportion\n * is already fair — no penalty term applies.\n *\n * @param correctBlanks - number of blanks answered correctly\n * @param totalBlanks - total number of blanks; the `FillInTheBlanksDataSchema`\n *   `blanks.min(1)` constraint guarantees this is ≥ 1, so division by zero\n *   cannot occur for schema-validated data\n */\nexport function partialBlankStrategy(correctBlanks: number, totalBlanks: number): number {\n  return correctBlanks / totalBlanks;\n}\n","import type {\n  BlankConfig,\n  FillInTheBlanksData,\n  FillInTheBlanksLearnerResponse,\n  ScoringDetail,\n} from '../../types/activity.js';\nimport { allOrNothingStrategy } from '../strategies/all-or-nothing.js';\nimport { partialBlankStrategy } from '../strategies/partial.js';\nimport type { PartialScoringResult } from './multiple-choice.js';\n\n/**\n * Normalises a value for comparison per the blank's rules.\n * Defaults: `trimWhitespace` true, `caseSensitive` false (case-insensitive\n * unless the author explicitly opts in).\n */\nfunction normalize(value: string, blank: BlankConfig): string {\n  let result = value;\n  if (blank.trimWhitespace !== false) {\n    result = result.trim();\n  }\n  if (blank.caseSensitive !== true) {\n    result = result.toLowerCase();\n  }\n  return result;\n}\n\n/**\n * Scores a Fill-in-the-Blanks response. Each blank is evaluated independently;\n * a missing answer key is treated as empty input and scored incorrect.\n */\nexport function scoreFillInTheBlanks(\n  data: FillInTheBlanksData,\n  response: FillInTheBlanksLearnerResponse,\n): PartialScoringResult {\n  const details: ScoringDetail[] = [];\n  const perBlankCorrect: boolean[] = [];\n\n  for (const blank of data.blanks) {\n    const rawInput = response.answers[blank.id];\n    const input = typeof rawInput === 'string' ? rawInput : '';\n    const normalizedInput = normalize(input, blank);\n    const matched = blank.acceptedAnswers.some(\n      (accepted) => normalize(accepted, blank) === normalizedInput,\n    );\n\n    perBlankCorrect.push(matched);\n    details.push({\n      itemId: blank.id,\n      correct: matched,\n      learnerResponse: [input],\n      correctResponse: [...blank.acceptedAnswers],\n    });\n  }\n\n  const correctBlanks = perBlankCorrect.filter(Boolean).length;\n  const scoreValue =\n    data.scoringStrategy === 'all-or-nothing'\n      ? allOrNothingStrategy(perBlankCorrect)\n      : partialBlankStrategy(correctBlanks, data.blanks.length);\n\n  return { score: scoreValue, maxScore: 1, feedback: null, details };\n}\n","import type {\n  MultipleChoiceData,\n  MultipleChoiceLearnerResponse,\n  ScoringDetail,\n  ScoringResult,\n} from '../../types/activity.js';\nimport { partialStrategy } from '../strategies/partial.js';\n\n/** ScoringResult without `passed` — the public `score()` fills that in. */\nexport type PartialScoringResult = Omit<ScoringResult, 'passed'>;\n\n/**\n * Scores a Multiple Choice response. Pure; trusts its typed inputs (validation\n * is the component boundary's job). Options are looked up by id; an unknown\n * selected id is treated as an incorrect selection.\n */\nexport function scoreMultipleChoice(\n  data: MultipleChoiceData,\n  response: MultipleChoiceLearnerResponse,\n): PartialScoringResult {\n  const optionById = new Map(data.options.map((option) => [option.id, option]));\n  const selected = new Set(response.selectedOptionIds);\n\n  const totalCorrect = data.options.filter((option) => option.isCorrect).length;\n  const totalIncorrect = data.options.length - totalCorrect;\n\n  let scoreValue: number;\n\n  if (data.scoringStrategy === 'all-or-nothing') {\n    if (data.mode === 'single') {\n      scoreValue =\n        response.selectedOptionIds.length === 1 &&\n        optionById.get(response.selectedOptionIds[0])?.isCorrect === true\n          ? 1\n          : 0;\n    } else {\n      const correctIds = data.options.filter((o) => o.isCorrect).map((o) => o.id);\n      const allCorrectSelected = correctIds.every((id) => selected.has(id));\n      scoreValue = selected.size === correctIds.length && allCorrectSelected ? 1 : 0;\n    }\n  } else {\n    let correctSelected = 0;\n    let incorrectSelected = 0;\n    for (const id of selected) {\n      const option = optionById.get(id);\n      if (option?.isCorrect) {\n        correctSelected += 1;\n      } else {\n        incorrectSelected += 1;\n      }\n    }\n    scoreValue = partialStrategy(correctSelected, incorrectSelected, totalCorrect, totalIncorrect);\n  }\n\n  const details: ScoringDetail[] = data.options.map((option) => {\n    const wasSelected = selected.has(option.id);\n    return {\n      itemId: option.id,\n      correct: wasSelected === option.isCorrect,\n      learnerResponse: [wasSelected ? 'selected' : 'not-selected'],\n      correctResponse: [option.isCorrect ? 'selected' : 'not-selected'],\n    };\n  });\n\n  return { score: scoreValue, maxScore: 1, feedback: null, details };\n}\n","import { UnknownActivityTypeError } from '../errors.js';\nimport type {\n  ActivityData,\n  ActivityType,\n  FillInTheBlanksData,\n  FillInTheBlanksLearnerResponse,\n  LearnerResponse,\n  MultipleChoiceData,\n  MultipleChoiceLearnerResponse,\n  ScoringResult,\n} from '../types/activity.js';\nimport { scoreFillInTheBlanks } from './activity-scorers/fill-in-the-blanks.js';\nimport { scoreMultipleChoice } from './activity-scorers/multiple-choice.js';\n\n/** Default minimum scaled score required to pass when `passThreshold` is absent. */\nconst DEFAULT_PASS_THRESHOLD = 0.7;\n\n/**\n * Returns `true` iff `score` meets or exceeds the activity's `passThreshold`,\n * defaulting to {@link DEFAULT_PASS_THRESHOLD} when the field is absent.\n */\nexport function computePassThreshold(activityData: ActivityData, score: number): boolean {\n  return score >= (activityData.passThreshold ?? DEFAULT_PASS_THRESHOLD);\n}\n\n/**\n * Scores a learner response against activity data and returns a full\n * {@link ScoringResult}.\n *\n * Pure and deterministic with no side effects. It does **not** re-validate\n * `activityData` — schema validation is the component boundary's\n * responsibility; this is a low-level scoring primitive that trusts its typed\n * inputs. Dispatches on `activityType`; an unrecognised type throws\n * {@link UnknownActivityTypeError}.\n */\nexport function score(\n  activityType: ActivityType,\n  activityData: ActivityData,\n  learnerResponse: LearnerResponse,\n): ScoringResult {\n  let result: Omit<ScoringResult, 'passed'>;\n\n  switch (activityType) {\n    case 'multiple-choice':\n      result = scoreMultipleChoice(\n        activityData as MultipleChoiceData,\n        learnerResponse as MultipleChoiceLearnerResponse,\n      );\n      break;\n    case 'fill-in-the-blanks':\n      result = scoreFillInTheBlanks(\n        activityData as FillInTheBlanksData,\n        learnerResponse as FillInTheBlanksLearnerResponse,\n      );\n      break;\n    default:\n      throw new UnknownActivityTypeError(String(activityType));\n  }\n\n  return { ...result, passed: computePassThreshold(activityData, result.score) };\n}\n"]}