@intellectif/lk-core 0.2.0

package/dist/index.js

@@ -0,0 +1,45 @@
+import {
+  computePassThreshold,
+  score
+} from "./chunk-GZ73G2TS.js";
+import {
+  XAPIVerb,
+  XAPI_VERB_DISPLAY,
+  validateXAPIStatement,
+  xAPIBuilder
+} from "./chunk-ZHOX6TO4.js";
+import {
+  ActivitySchemaError,
+  UnknownActivityTypeError
+} from "./chunk-6VOCV4EX.js";
+import {
+  BlankConfigSchema,
+  FeedbackSchema,
+  FillInTheBlanksDataSchema,
+  MediaSchema,
+  MultipleChoiceDataSchema,
+  MultipleChoiceOptionSchema,
+  fillInTheBlanksJsonSchema,
+  multipleChoiceJsonSchema,
+  validateActivity
+} from "./chunk-2T3IL7VL.js";
+export {
+  ActivitySchemaError,
+  BlankConfigSchema,
+  FeedbackSchema,
+  FillInTheBlanksDataSchema,
+  MediaSchema,
+  MultipleChoiceDataSchema,
+  MultipleChoiceOptionSchema,
+  UnknownActivityTypeError,
+  XAPIVerb,
+  XAPI_VERB_DISPLAY,
+  computePassThreshold,
+  fillInTheBlanksJsonSchema,
+  multipleChoiceJsonSchema,
+  score,
+  validateActivity,
+  validateXAPIStatement,
+  xAPIBuilder
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/schemas.cjs

@@ -0,0 +1,23 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+var _chunkDCDOTQNHcjs = require('./chunk-DCDOTQNH.cjs');
+
+
+
+
+
+
+
+
+
+
+exports.BlankConfigSchema = _chunkDCDOTQNHcjs.BlankConfigSchema; exports.FeedbackSchema = _chunkDCDOTQNHcjs.FeedbackSchema; exports.FillInTheBlanksDataSchema = _chunkDCDOTQNHcjs.FillInTheBlanksDataSchema; exports.MediaSchema = _chunkDCDOTQNHcjs.MediaSchema; exports.MultipleChoiceDataSchema = _chunkDCDOTQNHcjs.MultipleChoiceDataSchema; exports.MultipleChoiceOptionSchema = _chunkDCDOTQNHcjs.MultipleChoiceOptionSchema; exports.fillInTheBlanksJsonSchema = _chunkDCDOTQNHcjs.fillInTheBlanksJsonSchema; exports.multipleChoiceJsonSchema = _chunkDCDOTQNHcjs.multipleChoiceJsonSchema; exports.validateActivity = _chunkDCDOTQNHcjs.validateActivity;
+//# sourceMappingURL=schemas.cjs.map

package/dist/schemas.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["c:\\Users\\onecu\\Documents\\Intellectif\\IT-for-Intellectif\\learning-kit\\packages\\lk-core\\dist\\schemas.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,koBAAC","file":"C:\\Users\\onecu\\Documents\\Intellectif\\IT-for-Intellectif\\learning-kit\\packages\\lk-core\\dist\\schemas.cjs"}

package/dist/schemas.d.cts

@@ -0,0 +1,179 @@
+import { e as ActivityType, j as ValidationResult, a as ActivityDataMap } from './activity-D5tqgx8A.cjs';
+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.$strip>;
+
+/** Zod schema for a single fill-in-the-blank slot configuration. */
+declare const BlankConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    acceptedAnswers: z.ZodArray<z.ZodString>;
+    caseSensitive: z.ZodOptional<z.ZodBoolean>;
+    trimWhitespace: z.ZodOptional<z.ZodBoolean>;
+    hint: z.ZodOptional<z.ZodString>;
+    feedback: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema validating the full Fill-in-the-Blanks activity data contract.
+ *
+ * The refinement enforces a bijection between `{{id}}` placeholders in the
+ * passage and `blanks[].id`; otherwise a blank could never be rendered, or a
+ * placeholder could have no scoring config, yielding undefined behaviour.
+ */
+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;
+    blanks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        acceptedAnswers: z.ZodArray<z.ZodString>;
+        caseSensitive: z.ZodOptional<z.ZodBoolean>;
+        trimWhitespace: z.ZodOptional<z.ZodBoolean>;
+        hint: z.ZodOptional<z.ZodString>;
+        feedback: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    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.ZodURL;
+        alt: z.ZodOptional<z.ZodString>;
+        captionsUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        correct: z.ZodOptional<z.ZodString>;
+        incorrect: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    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.$strip>;
+
+/**
+ * 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.
+ */
+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;
+
+/**
+ * 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).
+ */
+declare const MediaSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        audio: "audio";
+        video: "video";
+        embed: "embed";
+    }>;
+    url: z.ZodURL;
+    alt: z.ZodOptional<z.ZodString>;
+    captionsUrl: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+
+/** Zod schema for a single Multiple Choice option. */
+declare const MultipleChoiceOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    isCorrect: z.ZodBoolean;
+    feedback: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema validating the full Multiple Choice activity data contract.
+ *
+ * Two 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. Both 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;
+    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.$strip>>;
+    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.ZodURL;
+        alt: z.ZodOptional<z.ZodString>;
+        captionsUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        correct: z.ZodOptional<z.ZodString>;
+        incorrect: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    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.$strip>;
+
+/**
+ * Validates raw activity data against the schema for the given activity type.
+ *
+ * @returns `{ success: true, data }` with the typed, validated data, or
+ *          `{ success: false, errors }` with one entry per failed constraint.
+ */
+declare function validateActivity<T extends ActivityType>(type: T, data: unknown): ValidationResult<ActivityDataMap[T]>;
+
+export { BlankConfigSchema, FeedbackSchema, FillInTheBlanksDataSchema, MediaSchema, MultipleChoiceDataSchema, MultipleChoiceOptionSchema, fillInTheBlanksJsonSchema, multipleChoiceJsonSchema, validateActivity };

package/dist/schemas.d.ts

@@ -0,0 +1,179 @@
+import { e as ActivityType, j as ValidationResult, a as ActivityDataMap } from './activity-D5tqgx8A.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.$strip>;
+
+/** Zod schema for a single fill-in-the-blank slot configuration. */
+declare const BlankConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    acceptedAnswers: z.ZodArray<z.ZodString>;
+    caseSensitive: z.ZodOptional<z.ZodBoolean>;
+    trimWhitespace: z.ZodOptional<z.ZodBoolean>;
+    hint: z.ZodOptional<z.ZodString>;
+    feedback: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema validating the full Fill-in-the-Blanks activity data contract.
+ *
+ * The refinement enforces a bijection between `{{id}}` placeholders in the
+ * passage and `blanks[].id`; otherwise a blank could never be rendered, or a
+ * placeholder could have no scoring config, yielding undefined behaviour.
+ */
+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;
+    blanks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        acceptedAnswers: z.ZodArray<z.ZodString>;
+        caseSensitive: z.ZodOptional<z.ZodBoolean>;
+        trimWhitespace: z.ZodOptional<z.ZodBoolean>;
+        hint: z.ZodOptional<z.ZodString>;
+        feedback: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    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.ZodURL;
+        alt: z.ZodOptional<z.ZodString>;
+        captionsUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        correct: z.ZodOptional<z.ZodString>;
+        incorrect: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    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.$strip>;
+
+/**
+ * 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.
+ */
+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;
+
+/**
+ * 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).
+ */
+declare const MediaSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        audio: "audio";
+        video: "video";
+        embed: "embed";
+    }>;
+    url: z.ZodURL;
+    alt: z.ZodOptional<z.ZodString>;
+    captionsUrl: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+
+/** Zod schema for a single Multiple Choice option. */
+declare const MultipleChoiceOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    isCorrect: z.ZodBoolean;
+    feedback: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema validating the full Multiple Choice activity data contract.
+ *
+ * Two 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. Both 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;
+    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.$strip>>;
+    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.ZodURL;
+        alt: z.ZodOptional<z.ZodString>;
+        captionsUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        correct: z.ZodOptional<z.ZodString>;
+        incorrect: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    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.$strip>;
+
+/**
+ * Validates raw activity data against the schema for the given activity type.
+ *
+ * @returns `{ success: true, data }` with the typed, validated data, or
+ *          `{ success: false, errors }` with one entry per failed constraint.
+ */
+declare function validateActivity<T extends ActivityType>(type: T, data: unknown): ValidationResult<ActivityDataMap[T]>;
+
+export { BlankConfigSchema, FeedbackSchema, FillInTheBlanksDataSchema, MediaSchema, MultipleChoiceDataSchema, MultipleChoiceOptionSchema, fillInTheBlanksJsonSchema, multipleChoiceJsonSchema, validateActivity };

package/dist/schemas.js

@@ -0,0 +1,23 @@
+import {
+  BlankConfigSchema,
+  FeedbackSchema,
+  FillInTheBlanksDataSchema,
+  MediaSchema,
+  MultipleChoiceDataSchema,
+  MultipleChoiceOptionSchema,
+  fillInTheBlanksJsonSchema,
+  multipleChoiceJsonSchema,
+  validateActivity
+} from "./chunk-2T3IL7VL.js";
+export {
+  BlankConfigSchema,
+  FeedbackSchema,
+  FillInTheBlanksDataSchema,
+  MediaSchema,
+  MultipleChoiceDataSchema,
+  MultipleChoiceOptionSchema,
+  fillInTheBlanksJsonSchema,
+  multipleChoiceJsonSchema,
+  validateActivity
+};
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/scoring.cjs

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk3JMLUUFScjs = require('./chunk-3JMLUUFS.cjs');
+require('./chunk-DV466SBJ.cjs');
+
+
+
+exports.computePassThreshold = _chunk3JMLUUFScjs.computePassThreshold; exports.score = _chunk3JMLUUFScjs.score;
+//# sourceMappingURL=scoring.cjs.map

package/dist/scoring.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["c:\\Users\\onecu\\Documents\\Intellectif\\IT-for-Intellectif\\learning-kit\\packages\\lk-core\\dist\\scoring.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACF,+GAAC","file":"C:\\Users\\onecu\\Documents\\Intellectif\\IT-for-Intellectif\\learning-kit\\packages\\lk-core\\dist\\scoring.cjs"}

package/dist/scoring.d.cts

@@ -0,0 +1,20 @@
+import { A as ActivityData, e as ActivityType, L as LearnerResponse, i as ScoringResult } from './activity-D5tqgx8A.cjs';
+
+/**
+ * Returns `true` iff `score` meets or exceeds the activity's `passThreshold`,
+ * defaulting to {@link DEFAULT_PASS_THRESHOLD} when the field is absent.
+ */
+declare function computePassThreshold(activityData: ActivityData, score: number): boolean;
+/**
+ * Scores a learner response against activity data and returns a full
+ * {@link ScoringResult}.
+ *
+ * Pure and deterministic with no side effects. It does **not** re-validate
+ * `activityData` — schema validation is the component boundary's
+ * responsibility; this is a low-level scoring primitive that trusts its typed
+ * inputs. Dispatches on `activityType`; an unrecognised type throws
+ * {@link UnknownActivityTypeError}.
+ */
+declare function score(activityType: ActivityType, activityData: ActivityData, learnerResponse: LearnerResponse): ScoringResult;
+
+export { computePassThreshold, score };

package/dist/scoring.d.ts

@@ -0,0 +1,20 @@
+import { A as ActivityData, e as ActivityType, L as LearnerResponse, i as ScoringResult } from './activity-D5tqgx8A.js';
+
+/**
+ * Returns `true` iff `score` meets or exceeds the activity's `passThreshold`,
+ * defaulting to {@link DEFAULT_PASS_THRESHOLD} when the field is absent.
+ */
+declare function computePassThreshold(activityData: ActivityData, score: number): boolean;
+/**
+ * Scores a learner response against activity data and returns a full
+ * {@link ScoringResult}.
+ *
+ * Pure and deterministic with no side effects. It does **not** re-validate
+ * `activityData` — schema validation is the component boundary's
+ * responsibility; this is a low-level scoring primitive that trusts its typed
+ * inputs. Dispatches on `activityType`; an unrecognised type throws
+ * {@link UnknownActivityTypeError}.
+ */
+declare function score(activityType: ActivityType, activityData: ActivityData, learnerResponse: LearnerResponse): ScoringResult;
+
+export { computePassThreshold, score };

package/dist/scoring.js

@@ -0,0 +1,10 @@
+import {
+  computePassThreshold,
+  score
+} from "./chunk-GZ73G2TS.js";
+import "./chunk-6VOCV4EX.js";
+export {
+  computePassThreshold,
+  score
+};
+//# sourceMappingURL=scoring.js.map

package/dist/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/xapi.cjs

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkPJFDAP54cjs = require('./chunk-PJFDAP54.cjs');
+require('./chunk-DV466SBJ.cjs');
+
+
+
+
+
+exports.XAPIVerb = _chunkPJFDAP54cjs.XAPIVerb; exports.XAPI_VERB_DISPLAY = _chunkPJFDAP54cjs.XAPI_VERB_DISPLAY; exports.validateXAPIStatement = _chunkPJFDAP54cjs.validateXAPIStatement; exports.xAPIBuilder = _chunkPJFDAP54cjs.xAPIBuilder;
+//# sourceMappingURL=xapi.cjs.map

package/dist/xapi.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["c:\\Users\\onecu\\Documents\\Intellectif\\IT-for-Intellectif\\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":"C:\\Users\\onecu\\Documents\\Intellectif\\IT-for-Intellectif\\learning-kit\\packages\\lk-core\\dist\\xapi.cjs"}

package/dist/xapi.d.cts

@@ -0,0 +1,88 @@
+import { X as XAPIActor, i as ScoringResult, l as XAPIContext, o as XAPIResult, q as XAPIStatement } from './activity-D5tqgx8A.cjs';
+
+/**
+ * The set of xAPI verbs emitted by SDK activities, keyed by a stable
+ * identifier mapped to its canonical xAPI verb IRI (xAPI 1.0.3 / ADL registry).
+ */
+declare const XAPIVerb: {
+    readonly ANSWERED: "http://adlnet.gov/expapi/verbs/answered";
+    readonly COMPLETED: "http://adlnet.gov/expapi/verbs/completed";
+    readonly EXPERIENCED: "http://adlnet.gov/expapi/verbs/experienced";
+    readonly INTERACTED: "http://adlnet.gov/expapi/verbs/interacted";
+    readonly ATTEMPTED: "http://adlnet.gov/expapi/verbs/attempted";
+    readonly PASSED: "http://adlnet.gov/expapi/verbs/passed";
+    readonly FAILED: "http://adlnet.gov/expapi/verbs/failed";
+    readonly WATCHED: "https://w3id.org/xapi/video/verbs/watched";
+};
+/** Union of the valid `XAPIVerb` keys. */
+type XAPIVerbKey = keyof typeof XAPIVerb;
+/**
+ * Default `en-US` display label for each verb, used to populate
+ * `XAPIVerbObject.display` when the builder resolves a verb key.
+ */
+declare const XAPI_VERB_DISPLAY: Record<XAPIVerbKey, Record<string, string>>;
+
+/** Caller-supplied activity object descriptor (mapped to an xAPI Activity). */
+interface XAPIObjectParams {
+    /** Activity IRI. */
+    id: string;
+    name?: Record<string, string>;
+    description?: Record<string, string>;
+    /** Activity type IRI. */
+    type?: string;
+}
+/** Parameters for the generic {@link xAPIBuilder.buildStatement}. */
+interface XAPIStatementParams {
+    actor: XAPIActor;
+    verb: XAPIVerbKey;
+    object: XAPIObjectParams;
+    result?: XAPIResult;
+    context?: XAPIContext;
+}
+/** Parameters for {@link xAPIBuilder.buildAnsweredStatement} (verb = ANSWERED). */
+interface AnsweredStatementParams {
+    actor: XAPIActor;
+    object: XAPIObjectParams;
+    scoringResult: ScoringResult;
+    timeSpentMs: number;
+    /** Serialized learner response string. */
+    response?: string;
+    context?: XAPIContext;
+    resultExtensions?: Record<string, unknown>;
+}
+/** Parameters for {@link xAPIBuilder.buildCompletedStatement} (verb = COMPLETED). */
+interface CompletedStatementParams {
+    actor: XAPIActor;
+    object: XAPIObjectParams;
+    scoringResult?: ScoringResult;
+    timeSpentMs: number;
+    context?: XAPIContext;
+    resultExtensions?: Record<string, unknown>;
+}
+/**
+ * Constructs xAPI 1.0.3 Statements. Every call stamps a fresh UUID v4 `id`,
+ * an ISO 8601 `timestamp`, and `version: '1.0.3'`. Not pure by design —
+ * statements are unique events.
+ */
+declare const xAPIBuilder: {
+    buildStatement(params: XAPIStatementParams): XAPIStatement;
+    buildAnsweredStatement(params: AnsweredStatementParams): XAPIStatement;
+    buildCompletedStatement(params: CompletedStatementParams): XAPIStatement;
+};
+
+/**
+ * Validates a constructed {@link XAPIStatement} against the xAPI 1.0.3
+ * structural contract.
+ *
+ * In development a structural failure throws (caught early); in production it
+ * logs a warning and returns (the statement is still sent — see the design's
+ * Error Handling table). Uses a `zod/v4` schema rather than `ajv` + an
+ * external JSON Schema to keep `lk-core` dependency-free.
+ *
+ * NOTE: `ActivitySchemaError` is reused here per the task spec; its
+ * `activityType` field carries the sentinel `'xAPIStatement'`. A dedicated
+ * `XAPIValidationError` would be semantically cleaner — flagged for review.
+ */
+declare function validateXAPIStatement(statement: XAPIStatement): void;
+
+export { type AnsweredStatementParams, type CompletedStatementParams, type XAPIObjectParams, type XAPIStatementParams, XAPIVerb, type XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder };