@intellectif/lk-core 0.3.0 → 0.4.0

package/dist/scoring.d.cts

@@ -1,5 +1,192 @@
-import { A as ActivityData, L as LearnerResponse, h as ItemOutcome, e as ActivityType, m as ScoringResult } from './activity-zdcAMtFB.cjs';
-export { T as TextMatchPolicy, n as TextMatchResult, E as levenshteinDistance, G as matchText } from './activity-zdcAMtFB.cjs';
+import { m as ItemOutcome, A as ActivityData, L as LearnerResponse, e as ActivityType, r as ScoringResult } from './activity-wkzRemHx.cjs';
+export { T as TextMatchPolicy, s as TextMatchResult, P as levenshteinDistance, Q as matchText } from './activity-wkzRemHx.cjs';
+
+/**
+ * Rounding for assessment scores.
+ *
+ * Rounding is **two different operations** that must not share one policy, and
+ * conflating them silently inverts one of them:
+ *
+ * - **Grade rounding** decides the number a learner is shown and recorded
+ *   against. It rounds to a fixed number of decimal places, conventionally
+ *   half-up, so a learner shown "70%" is not recorded as a fail at 69.6.
+ * - **Band / level classification** decides which level someone is placed in.
+ *   It deliberately **floors**: placing a learner above their real level is
+ *   the more harmful error, so a band boundary must not be reached by
+ *   rounding up.
+ *
+ * There is therefore no default `RoundingPolicy` anywhere in this SDK, and
+ * `dp` has no default either — an integrator's deliberate choice must never be
+ * supplied by us.
+ */
+/** How a value is rounded to `dp` decimal places. */
+type RoundingMode = 'half-up' | 'half-even' | 'floor' | 'ceil';
+/** A rounding policy. Both fields are required — the SDK never guesses either. */
+interface RoundingPolicy {
+    mode: RoundingMode;
+    /** Decimal places. Load-bearing: `dp: 2` is what stops 69.6 becoming a fail at 70. */
+    dp: number;
+}
+/**
+ * Rounds `value` to `policy.dp` places under `policy.mode`.
+ *
+ * Idempotent for every mode: rounding an already-rounded value returns it
+ * unchanged. That matters because a composed score is rounded once and then
+ * compared through {@link gte}, which rounds again.
+ */
+declare function roundGrade(value: number, policy: RoundingPolicy): number;
+/**
+ * Threshold comparison that rounds **both sides** before comparing.
+ *
+ * Comparing a raw float against a rounded threshold is how a learner ends up
+ * shown one number and recorded against another. Rounding both sides — and
+ * allowing an epsilon — makes "what the learner sees" and "what the gradebook
+ * decides" the same comparison.
+ */
+declare function gte(value: number, threshold: number, policy: RoundingPolicy): boolean;
+/** A named band with an inclusive lower bound, e.g. `{ name: 'B1', min: 0.6 }`. */
+interface Band {
+    name: string;
+    /** Inclusive lower bound on the same scale as the value being classified. */
+    min: number;
+}
+/**
+ * Classifies a value into a band by **flooring**: the highest band whose `min`
+ * the value actually reaches. Deliberately does NOT round up to a boundary —
+ * over-placement is the more harmful error, so a learner just below a boundary
+ * stays below it.
+ *
+ * Returns `null` when the value reaches no band's minimum.
+ */
+declare function classifyBand(value: number, bands: readonly Band[]): Band | null;
+
+/**
+ * Sectioned assessment scoring — weights, per-section thresholds, and an
+ * explicit reason when an attempt fails.
+ *
+ * This exists because the formula is invariably implemented twice: once on the
+ * server that records the grade, and again on the client that shows a learner
+ * their grade breakdown. Two implementations of one formula is exactly the
+ * duplication an SDK should remove, and they drift — usually in the scale
+ * (0–1 vs 0–100) or in whether a section override is honoured.
+ */
+/** One item's contribution to a section. */
+interface ScoredItem {
+    /**
+     * Identity of the SLOT, not the activity. The same activity can legitimately
+     * appear in two sections; keying on the activity id collapses them into one
+     * and silently scores the second occurrence as zero.
+     */
+    slotId: string;
+    /** The activity that filled this slot, for reporting. */
+    activityId?: string;
+    /** Maximum points this slot is worth. */
+    points: number;
+    /** What the learner achieved, or why there is no grade yet. */
+    outcome: ItemOutcome;
+}
+/** A weighted section of an assessment. */
+interface AssessmentSectionInput {
+    id: string;
+    title?: string;
+    /** Relative weight. Weights are normalised by their sum, so they need not total 1. */
+    weight: number;
+    /** Overrides the assessment-wide section threshold for this section only. */
+    passThresholdOverride?: number;
+    items: ScoredItem[];
+}
+/** Policy for {@link composeAssessmentScore}. */
+interface CompositionPolicy {
+    /** Scaled [0,1] overall score required to pass. */
+    passThreshold: number;
+    /** Scaled [0,1] score each section must reach, when sections gate the pass. */
+    sectionThreshold?: number;
+    /**
+     * How grades are rounded. Required, with no default: see `RoundingPolicy` —
+     * grade rounding and band classification are different operations and the
+     * SDK must not choose either for you.
+     */
+    rounding: RoundingPolicy;
+}
+/** Per-section result. */
+interface SectionScore {
+    id: string;
+    title?: string;
+    /** The authored weight, verbatim. */
+    weight: number;
+    /**
+     * The weight ACTUALLY used in the total, so a client can rebuild the grade
+     * from `sections[]` and agree with the record:
+     *
+     * ```ts
+     * roundGrade(
+     *   sections.reduce((sum, s) => sum + s.score * s.normalizedWeight, 0),
+     *   policy.rounding,
+     * ) === result.score            // exact, by construction
+     * ```
+     *
+     * Apply the same final rounding: the raw weighted sum of already-rounded
+     * section scores is not itself a rounded value (0.85 and 1.00 at equal
+     * weights sum to 0.925 against a recorded 0.93), so comparing it unrounded
+     * is off by up to half a quantum.
+     *
+     * Sections with nothing graded carry `0` here, because they contribute
+     * nothing; the remaining weights are renormalised among themselves.
+     */
+    normalizedWeight: number;
+    earnedPoints: number;
+    /** Points that are currently gradable — excludes items still awaiting a grade. */
+    gradedMaxPoints: number;
+    /** Every point in the section, whether graded yet or not. */
+    maxPoints: number;
+    /** Scaled [0,1] over the GRADED points, rounded once. */
+    score: number;
+    passed: boolean;
+    /** Threshold this section was judged against, after any override. */
+    appliedThreshold: number | null;
+    /** Slots still awaiting a grade. */
+    pendingSlotIds: string[];
+    /** Slots that can never be graded, excluded from the denominator. */
+    unscorableSlotIds: string[];
+}
+/** Why an attempt failed, or `null` when it passed. */
+type PassFailureReason = 'overall_below_threshold' | 'section_below_threshold' | 'both' | null;
+/** Result of composing an assessment. */
+interface AssessmentScore {
+    sections: SectionScore[];
+    /** Weighted total, scaled [0,1], rounded once. */
+    score: number;
+    /**
+     * Whether the attempt passed — `null` while `status` is `provisional`,
+     * because an attempt with work still ungraded has not passed OR failed yet.
+     * Returning `false` there would let a UI keyed on `passed` show a fail for
+     * an essay nobody has marked.
+     */
+    passed: boolean | null;
+    /** `null` while provisional, for the same reason as {@link passed}. */
+    passFailureReason: PassFailureReason;
+    /**
+     * `provisional` while any item is still awaiting a grade — the total is
+     * computed over what HAS been graded, so it can still move. Do not record a
+     * provisional score as final. Items that can NEVER be graded
+     * (`unscorableSlotIds`) do not hold the result provisional.
+     */
+    status: 'final' | 'provisional';
+    pendingSlotIds: string[];
+    /** Slots that can never be graded. Excluded from the denominator. */
+    unscorableSlotIds: string[];
+}
+/**
+ * Composes per-item outcomes into a sectioned assessment score.
+ *
+ * Weights are normalised by their sum. Each section's score is computed over
+ * the points that are actually gradable and rounded ONCE, before any threshold
+ * comparison, so the number a learner is shown is the number that decides the
+ * outcome. Items still awaiting a grade are excluded from the denominator
+ * rather than counted as zero, and the result is reported as `provisional`
+ * until every item has a grade.
+ */
+declare function composeAssessmentScore(sections: readonly AssessmentSectionInput[], policy: CompositionPolicy): AssessmentScore;
 
 /** Default minimum scaled score required to pass when `passThreshold` is absent. */
 declare const DEFAULT_PASS_THRESHOLD = 0.7;
@@ -41,4 +228,4 @@ declare function score(activityType: ActivityType, activityData: ActivityData, l
  */
 declare function evaluate(data: ActivityData, response: LearnerResponse): ItemOutcome;
 
-export { DEFAULT_PASS_THRESHOLD, computePassThreshold, evaluate, score };
+export { type AssessmentScore, type AssessmentSectionInput, type Band, type CompositionPolicy, DEFAULT_PASS_THRESHOLD, type PassFailureReason, type RoundingMode, type RoundingPolicy, type ScoredItem, type SectionScore, classifyBand, composeAssessmentScore, computePassThreshold, evaluate, gte, roundGrade, score };

package/dist/scoring.d.ts

@@ -1,5 +1,192 @@
-import { A as ActivityData, L as LearnerResponse, h as ItemOutcome, e as ActivityType, m as ScoringResult } from './activity-zdcAMtFB.js';
-export { T as TextMatchPolicy, n as TextMatchResult, E as levenshteinDistance, G as matchText } from './activity-zdcAMtFB.js';
+import { m as ItemOutcome, A as ActivityData, L as LearnerResponse, e as ActivityType, r as ScoringResult } from './activity-wkzRemHx.js';
+export { T as TextMatchPolicy, s as TextMatchResult, P as levenshteinDistance, Q as matchText } from './activity-wkzRemHx.js';
+
+/**
+ * Rounding for assessment scores.
+ *
+ * Rounding is **two different operations** that must not share one policy, and
+ * conflating them silently inverts one of them:
+ *
+ * - **Grade rounding** decides the number a learner is shown and recorded
+ *   against. It rounds to a fixed number of decimal places, conventionally
+ *   half-up, so a learner shown "70%" is not recorded as a fail at 69.6.
+ * - **Band / level classification** decides which level someone is placed in.
+ *   It deliberately **floors**: placing a learner above their real level is
+ *   the more harmful error, so a band boundary must not be reached by
+ *   rounding up.
+ *
+ * There is therefore no default `RoundingPolicy` anywhere in this SDK, and
+ * `dp` has no default either — an integrator's deliberate choice must never be
+ * supplied by us.
+ */
+/** How a value is rounded to `dp` decimal places. */
+type RoundingMode = 'half-up' | 'half-even' | 'floor' | 'ceil';
+/** A rounding policy. Both fields are required — the SDK never guesses either. */
+interface RoundingPolicy {
+    mode: RoundingMode;
+    /** Decimal places. Load-bearing: `dp: 2` is what stops 69.6 becoming a fail at 70. */
+    dp: number;
+}
+/**
+ * Rounds `value` to `policy.dp` places under `policy.mode`.
+ *
+ * Idempotent for every mode: rounding an already-rounded value returns it
+ * unchanged. That matters because a composed score is rounded once and then
+ * compared through {@link gte}, which rounds again.
+ */
+declare function roundGrade(value: number, policy: RoundingPolicy): number;
+/**
+ * Threshold comparison that rounds **both sides** before comparing.
+ *
+ * Comparing a raw float against a rounded threshold is how a learner ends up
+ * shown one number and recorded against another. Rounding both sides — and
+ * allowing an epsilon — makes "what the learner sees" and "what the gradebook
+ * decides" the same comparison.
+ */
+declare function gte(value: number, threshold: number, policy: RoundingPolicy): boolean;
+/** A named band with an inclusive lower bound, e.g. `{ name: 'B1', min: 0.6 }`. */
+interface Band {
+    name: string;
+    /** Inclusive lower bound on the same scale as the value being classified. */
+    min: number;
+}
+/**
+ * Classifies a value into a band by **flooring**: the highest band whose `min`
+ * the value actually reaches. Deliberately does NOT round up to a boundary —
+ * over-placement is the more harmful error, so a learner just below a boundary
+ * stays below it.
+ *
+ * Returns `null` when the value reaches no band's minimum.
+ */
+declare function classifyBand(value: number, bands: readonly Band[]): Band | null;
+
+/**
+ * Sectioned assessment scoring — weights, per-section thresholds, and an
+ * explicit reason when an attempt fails.
+ *
+ * This exists because the formula is invariably implemented twice: once on the
+ * server that records the grade, and again on the client that shows a learner
+ * their grade breakdown. Two implementations of one formula is exactly the
+ * duplication an SDK should remove, and they drift — usually in the scale
+ * (0–1 vs 0–100) or in whether a section override is honoured.
+ */
+/** One item's contribution to a section. */
+interface ScoredItem {
+    /**
+     * Identity of the SLOT, not the activity. The same activity can legitimately
+     * appear in two sections; keying on the activity id collapses them into one
+     * and silently scores the second occurrence as zero.
+     */
+    slotId: string;
+    /** The activity that filled this slot, for reporting. */
+    activityId?: string;
+    /** Maximum points this slot is worth. */
+    points: number;
+    /** What the learner achieved, or why there is no grade yet. */
+    outcome: ItemOutcome;
+}
+/** A weighted section of an assessment. */
+interface AssessmentSectionInput {
+    id: string;
+    title?: string;
+    /** Relative weight. Weights are normalised by their sum, so they need not total 1. */
+    weight: number;
+    /** Overrides the assessment-wide section threshold for this section only. */
+    passThresholdOverride?: number;
+    items: ScoredItem[];
+}
+/** Policy for {@link composeAssessmentScore}. */
+interface CompositionPolicy {
+    /** Scaled [0,1] overall score required to pass. */
+    passThreshold: number;
+    /** Scaled [0,1] score each section must reach, when sections gate the pass. */
+    sectionThreshold?: number;
+    /**
+     * How grades are rounded. Required, with no default: see `RoundingPolicy` —
+     * grade rounding and band classification are different operations and the
+     * SDK must not choose either for you.
+     */
+    rounding: RoundingPolicy;
+}
+/** Per-section result. */
+interface SectionScore {
+    id: string;
+    title?: string;
+    /** The authored weight, verbatim. */
+    weight: number;
+    /**
+     * The weight ACTUALLY used in the total, so a client can rebuild the grade
+     * from `sections[]` and agree with the record:
+     *
+     * ```ts
+     * roundGrade(
+     *   sections.reduce((sum, s) => sum + s.score * s.normalizedWeight, 0),
+     *   policy.rounding,
+     * ) === result.score            // exact, by construction
+     * ```
+     *
+     * Apply the same final rounding: the raw weighted sum of already-rounded
+     * section scores is not itself a rounded value (0.85 and 1.00 at equal
+     * weights sum to 0.925 against a recorded 0.93), so comparing it unrounded
+     * is off by up to half a quantum.
+     *
+     * Sections with nothing graded carry `0` here, because they contribute
+     * nothing; the remaining weights are renormalised among themselves.
+     */
+    normalizedWeight: number;
+    earnedPoints: number;
+    /** Points that are currently gradable — excludes items still awaiting a grade. */
+    gradedMaxPoints: number;
+    /** Every point in the section, whether graded yet or not. */
+    maxPoints: number;
+    /** Scaled [0,1] over the GRADED points, rounded once. */
+    score: number;
+    passed: boolean;
+    /** Threshold this section was judged against, after any override. */
+    appliedThreshold: number | null;
+    /** Slots still awaiting a grade. */
+    pendingSlotIds: string[];
+    /** Slots that can never be graded, excluded from the denominator. */
+    unscorableSlotIds: string[];
+}
+/** Why an attempt failed, or `null` when it passed. */
+type PassFailureReason = 'overall_below_threshold' | 'section_below_threshold' | 'both' | null;
+/** Result of composing an assessment. */
+interface AssessmentScore {
+    sections: SectionScore[];
+    /** Weighted total, scaled [0,1], rounded once. */
+    score: number;
+    /**
+     * Whether the attempt passed — `null` while `status` is `provisional`,
+     * because an attempt with work still ungraded has not passed OR failed yet.
+     * Returning `false` there would let a UI keyed on `passed` show a fail for
+     * an essay nobody has marked.
+     */
+    passed: boolean | null;
+    /** `null` while provisional, for the same reason as {@link passed}. */
+    passFailureReason: PassFailureReason;
+    /**
+     * `provisional` while any item is still awaiting a grade — the total is
+     * computed over what HAS been graded, so it can still move. Do not record a
+     * provisional score as final. Items that can NEVER be graded
+     * (`unscorableSlotIds`) do not hold the result provisional.
+     */
+    status: 'final' | 'provisional';
+    pendingSlotIds: string[];
+    /** Slots that can never be graded. Excluded from the denominator. */
+    unscorableSlotIds: string[];
+}
+/**
+ * Composes per-item outcomes into a sectioned assessment score.
+ *
+ * Weights are normalised by their sum. Each section's score is computed over
+ * the points that are actually gradable and rounded ONCE, before any threshold
+ * comparison, so the number a learner is shown is the number that decides the
+ * outcome. Items still awaiting a grade are excluded from the denominator
+ * rather than counted as zero, and the result is reported as `provisional`
+ * until every item has a grade.
+ */
+declare function composeAssessmentScore(sections: readonly AssessmentSectionInput[], policy: CompositionPolicy): AssessmentScore;
 
 /** Default minimum scaled score required to pass when `passThreshold` is absent. */
 declare const DEFAULT_PASS_THRESHOLD = 0.7;
@@ -41,4 +228,4 @@ declare function score(activityType: ActivityType, activityData: ActivityData, l
  */
 declare function evaluate(data: ActivityData, response: LearnerResponse): ItemOutcome;
 
-export { DEFAULT_PASS_THRESHOLD, computePassThreshold, evaluate, score };
+export { type AssessmentScore, type AssessmentSectionInput, type Band, type CompositionPolicy, DEFAULT_PASS_THRESHOLD, type PassFailureReason, type RoundingMode, type RoundingPolicy, type ScoredItem, type SectionScore, classifyBand, composeAssessmentScore, computePassThreshold, evaluate, gte, roundGrade, score };

package/dist/scoring.js

@@ -1,9 +1,13 @@
 import {
   DEFAULT_PASS_THRESHOLD,
+  classifyBand,
+  composeAssessmentScore,
   computePassThreshold,
   evaluate,
+  gte,
+  roundGrade,
   score
-} from "./chunk-QSVBYTNM.js";
+} from "./chunk-A6JXV5GP.js";
 import {
   levenshteinDistance,
   matchText
@@ -11,10 +15,14 @@ import {
 import "./chunk-3YAVDV5F.js";
 export {
   DEFAULT_PASS_THRESHOLD,
+  classifyBand,
+  composeAssessmentScore,
   computePassThreshold,
   evaluate,
+  gte,
   levenshteinDistance,
   matchText,
+  roundGrade,
   score
 };
 //# sourceMappingURL=scoring.js.map

package/dist/xapi.cjs

@@ -3,12 +3,12 @@
 
 
 
-var _chunkRUGIOQZYcjs = require('./chunk-RUGIOQZY.cjs');
+var _chunkRUZ52Q7Acjs = require('./chunk-RUZ52Q7A.cjs');
 require('./chunk-PIMX4B4D.cjs');
 
 
 
 
 
-exports.XAPIVerb = _chunkRUGIOQZYcjs.XAPIVerb; exports.XAPI_VERB_DISPLAY = _chunkRUGIOQZYcjs.XAPI_VERB_DISPLAY; exports.validateXAPIStatement = _chunkRUGIOQZYcjs.validateXAPIStatement; exports.xAPIBuilder = _chunkRUGIOQZYcjs.xAPIBuilder;
+exports.XAPIVerb = _chunkRUZ52Q7Acjs.XAPIVerb; exports.XAPI_VERB_DISPLAY = _chunkRUZ52Q7Acjs.XAPI_VERB_DISPLAY; exports.validateXAPIStatement = _chunkRUZ52Q7Acjs.validateXAPIStatement; exports.xAPIBuilder = _chunkRUZ52Q7Acjs.xAPIBuilder;
 //# sourceMappingURL=xapi.cjs.map

package/dist/xapi.d.cts

@@ -1,4 +1,4 @@
-import { X as XAPIActor, m as ScoringResult, t as XAPIContext, x as XAPIResult, z as XAPIStatement } from './activity-zdcAMtFB.cjs';
+import { X as XAPIActor, r as ScoringResult, y as XAPIContext, J as XAPIResult, N as XAPIStatement } from './activity-wkzRemHx.cjs';
 
 /**
  * The set of xAPI verbs emitted by SDK activities, keyed by a stable
@@ -21,6 +21,13 @@ declare const XAPIVerb: {
      * community choice (design decision recorded per Task 25.4).
      */
     readonly SUBMITTED: "http://activitystrea.ms/schema/1.0/submit";
+    /**
+     * Emitted when an asynchronous grader produces a grade for work that was
+     * previously only SUBMITTED. Distinct from `answered`, which asserts the
+     * grade existed at submission time — here the learner acted earlier and the
+     * grade arrived later, often from a different actor (an AI or a teacher).
+     */
+    readonly SCORED: "http://adlnet.gov/expapi/verbs/scored";
 };
 /** Union of the valid `XAPIVerb` keys. */
 type XAPIVerbKey = keyof typeof XAPIVerb;

package/dist/xapi.d.ts

@@ -1,4 +1,4 @@
-import { X as XAPIActor, m as ScoringResult, t as XAPIContext, x as XAPIResult, z as XAPIStatement } from './activity-zdcAMtFB.js';
+import { X as XAPIActor, r as ScoringResult, y as XAPIContext, J as XAPIResult, N as XAPIStatement } from './activity-wkzRemHx.js';
 
 /**
  * The set of xAPI verbs emitted by SDK activities, keyed by a stable
@@ -21,6 +21,13 @@ declare const XAPIVerb: {
      * community choice (design decision recorded per Task 25.4).
      */
     readonly SUBMITTED: "http://activitystrea.ms/schema/1.0/submit";
+    /**
+     * Emitted when an asynchronous grader produces a grade for work that was
+     * previously only SUBMITTED. Distinct from `answered`, which asserts the
+     * grade existed at submission time — here the learner acted earlier and the
+     * grade arrived later, often from a different actor (an AI or a teacher).
+     */
+    readonly SCORED: "http://adlnet.gov/expapi/verbs/scored";
 };
 /** Union of the valid `XAPIVerb` keys. */
 type XAPIVerbKey = keyof typeof XAPIVerb;

package/dist/xapi.js

@@ -3,7 +3,7 @@ import {
   XAPI_VERB_DISPLAY,
   validateXAPIStatement,
   xAPIBuilder
-} from "./chunk-HS7BYCGE.js";
+} from "./chunk-APDLWLYD.js";
 import "./chunk-3YAVDV5F.js";
 export {
   XAPIVerb,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellectif/lk-core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Schemas, scoring engine, and xAPI builder for learning-kit",
   "repository": {
     "type": "git",
@@ -10,24 +10,44 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./scoring": {
-      "types": "./dist/scoring.d.ts",
-      "import": "./dist/scoring.js",
-      "require": "./dist/scoring.cjs"
+      "import": {
+        "types": "./dist/scoring.d.ts",
+        "default": "./dist/scoring.js"
+      },
+      "require": {
+        "types": "./dist/scoring.d.cts",
+        "default": "./dist/scoring.cjs"
+      }
     },
     "./xapi": {
-      "types": "./dist/xapi.d.ts",
-      "import": "./dist/xapi.js",
-      "require": "./dist/xapi.cjs"
+      "import": {
+        "types": "./dist/xapi.d.ts",
+        "default": "./dist/xapi.js"
+      },
+      "require": {
+        "types": "./dist/xapi.d.cts",
+        "default": "./dist/xapi.cjs"
+      }
     },
     "./schemas": {
-      "types": "./dist/schemas.d.ts",
-      "import": "./dist/schemas.js",
-      "require": "./dist/schemas.cjs"
+      "import": {
+        "types": "./dist/schemas.d.ts",
+        "default": "./dist/schemas.js"
+      },
+      "require": {
+        "types": "./dist/schemas.d.cts",
+        "default": "./dist/schemas.cjs"
+      }
     }
   },
   "main": "./dist/index.cjs",
@@ -38,7 +58,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "zod": "^3.25.0"
+    "zod": "^3.25.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.6",
@@ -55,6 +75,8 @@
     "build": "tsup",
     "test": "vitest run",
     "coverage": "vitest run --coverage",
-    "lint": "biome check ."
+    "lint": "biome check .",
+    "publint": "publint",
+    "attw": "attw --pack . --ignore-rules no-resolution"
   }
 }

package/dist/chunk-HS7BYCGE.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/xapi/validators.ts","../src/xapi/verbs.ts","../src/xapi/builder.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport { ActivitySchemaError } from '../errors.js';\nimport type { ValidationError } from '../types/activity.js';\nimport type { XAPIStatement } from '../types/xapi.js';\n\nconst UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n// Minimal IRI/URI check: a scheme followed by ':'.\nconst IRI = /^[a-z][a-z0-9+.-]*:/i;\n\nconst langMap = z.record(z.string(), z.string());\nconst extensions = z.record(z.string(), z.unknown());\n\nconst actorSchema = z\n  .object({\n    objectType: z.literal('Agent'),\n    name: z.string().optional(),\n    mbox: z\n      .string()\n      .regex(/^mailto:/, 'mbox must be a mailto IRI')\n      .optional(),\n    account: z.object({ homePage: z.string(), name: z.string() }).optional(),\n  })\n  .refine((actor) => actor.mbox !== undefined || actor.account !== undefined, {\n    error: 'actor must be identified by an mbox or an account',\n  });\n\nconst statementSchema = z.object({\n  id: z.string().regex(UUID_V4, 'id must be a UUID v4'),\n  actor: actorSchema,\n  verb: z.object({\n    id: z.string().regex(IRI, 'verb.id must be an IRI'),\n    display: langMap,\n  }),\n  object: z.object({\n    objectType: z.literal('Activity'),\n    id: z.string().regex(IRI, 'object.id must be an IRI'),\n    definition: z\n      .object({\n        name: langMap.optional(),\n        description: langMap.optional(),\n        type: z.string().optional(),\n        interactionType: z.string().optional(),\n        correctResponsesPattern: z.array(z.string()).optional(),\n        choices: z.array(z.object({ id: z.string(), description: langMap.optional() })).optional(),\n        extensions: extensions.optional(),\n      })\n      .optional(),\n  }),\n  result: z\n    .object({\n      // xAPI 1.0.3 permits scaled in [-1, 1]; the SDK only emits [0, 1].\n      score: z\n        .object({\n          scaled: z.number().min(-1).max(1),\n          raw: z.number().optional(),\n          min: z.number().optional(),\n          max: z.number().optional(),\n        })\n        .optional(),\n      success: z.boolean().optional(),\n      completion: z.boolean().optional(),\n      duration: z.string().regex(/^P/, 'duration must be an ISO 8601 duration').optional(),\n      response: z.string().optional(),\n      extensions: extensions.optional(),\n    })\n    .optional(),\n  context: z\n    .object({\n      platform: z.string().optional(),\n      language: z.string().optional(),\n      contextActivities: z\n        .object({\n          parent: z\n            .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n            .optional(),\n          grouping: z\n            .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n            .optional(),\n          category: z\n            .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n            .optional(),\n          other: z\n            .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n            .optional(),\n        })\n        .optional(),\n      extensions: extensions.optional(),\n    })\n    .optional(),\n  timestamp: z\n    .string()\n    .refine((value) => !Number.isNaN(Date.parse(value)), 'timestamp must be ISO 8601'),\n  version: z.literal('1.0.3'),\n});\n\n/** True when running under `NODE_ENV=production`, safe in any environment. */\nfunction isProduction(): boolean {\n  const g = globalThis as { process?: { env?: Record<string, string | undefined> } };\n  return g.process?.env?.NODE_ENV === 'production';\n}\n\n/**\n * Validates a constructed {@link XAPIStatement} against the xAPI 1.0.3\n * structural contract.\n *\n * In development a structural failure throws (caught early); in production it\n * logs a warning and returns (the statement is still sent — see the design's\n * Error Handling table). Uses a `zod/v4` schema rather than `ajv` + an\n * external JSON Schema to keep `lk-core` dependency-free.\n *\n * NOTE: `ActivitySchemaError` is reused here per the task spec; its\n * `activityType` field carries the sentinel `'xAPIStatement'`. A dedicated\n * `XAPIValidationError` would be semantically cleaner — flagged for review.\n */\nexport function validateXAPIStatement(statement: XAPIStatement): void {\n  const result = statementSchema.safeParse(statement);\n  if (result.success) {\n    return;\n  }\n\n  const errors: ValidationError[] = result.error.issues.map((issue) => ({\n    path: issue.path.map(String),\n    message: issue.message,\n    code: issue.code,\n  }));\n\n  if (isProduction()) {\n    console.warn('[learning-kit] Invalid xAPI statement (sent anyway):', errors);\n    return;\n  }\n\n  throw new ActivitySchemaError('xAPIStatement', errors);\n}\n","/**\n * The set of xAPI verbs emitted by SDK activities, keyed by a stable\n * identifier mapped to its canonical xAPI verb IRI (xAPI 1.0.3 / ADL registry).\n */\nexport const XAPIVerb = {\n  ANSWERED: 'http://adlnet.gov/expapi/verbs/answered',\n  COMPLETED: 'http://adlnet.gov/expapi/verbs/completed',\n  EXPERIENCED: 'http://adlnet.gov/expapi/verbs/experienced',\n  INTERACTED: 'http://adlnet.gov/expapi/verbs/interacted',\n  ATTEMPTED: 'http://adlnet.gov/expapi/verbs/attempted',\n  PASSED: 'http://adlnet.gov/expapi/verbs/passed',\n  FAILED: 'http://adlnet.gov/expapi/verbs/failed',\n  WATCHED: 'https://w3id.org/xapi/video/verbs/watched',\n  /**\n   * Emitted for deferred-grading submissions (e.g. written-response): the\n   * learner has submitted work whose grade does not exist yet, so `answered`\n   * (which implies a scored response) would be wrong. xAPI 1.0.3 defines no\n   * canonical \"submit\" verb; the Activity Streams 1.0 IRI is the established\n   * community choice (design decision recorded per Task 25.4).\n   */\n  SUBMITTED: 'http://activitystrea.ms/schema/1.0/submit',\n} as const;\n\n/** Union of the valid `XAPIVerb` keys. */\nexport type XAPIVerbKey = keyof typeof XAPIVerb;\n\n/**\n * Default `en-US` display label for each verb, used to populate\n * `XAPIVerbObject.display` when the builder resolves a verb key.\n */\nexport const XAPI_VERB_DISPLAY: Record<XAPIVerbKey, Record<string, string>> = {\n  ANSWERED: { 'en-US': 'answered' },\n  COMPLETED: { 'en-US': 'completed' },\n  EXPERIENCED: { 'en-US': 'experienced' },\n  INTERACTED: { 'en-US': 'interacted' },\n  ATTEMPTED: { 'en-US': 'attempted' },\n  PASSED: { 'en-US': 'passed' },\n  FAILED: { 'en-US': 'failed' },\n  WATCHED: { 'en-US': 'watched' },\n  SUBMITTED: { 'en-US': 'submitted' },\n};\n","import type { ScoringResult } from '../types/activity.js';\nimport type {\n  XAPIActor,\n  XAPIContext,\n  XAPIObject,\n  XAPIResult,\n  XAPIStatement,\n} from '../types/xapi.js';\nimport { validateXAPIStatement } from './validators.js';\nimport { XAPI_VERB_DISPLAY, XAPIVerb, type XAPIVerbKey } from './verbs.js';\n\n/** Caller-supplied activity object descriptor (mapped to an xAPI Activity). */\nexport interface XAPIObjectParams {\n  /** Activity IRI. */\n  id: string;\n  name?: Record<string, string>;\n  description?: Record<string, string>;\n  /** Activity type IRI. */\n  type?: string;\n  /** xAPI cmi.interaction type (e.g. `choice`, `fill-in`, `long-fill-in`). */\n  interactionType?: string;\n  /** Correct-responses patterns, per the xAPI CRP format. */\n  correctResponsesPattern?: string[];\n  /** For choice-family interactions: the available components. */\n  choices?: Array<{ id: string; description?: Record<string, string> }>;\n}\n\n/** Parameters for the generic {@link xAPIBuilder.buildStatement}. */\nexport interface XAPIStatementParams {\n  actor: XAPIActor;\n  verb: XAPIVerbKey;\n  object: XAPIObjectParams;\n  result?: XAPIResult;\n  context?: XAPIContext;\n}\n\n/** Parameters for {@link xAPIBuilder.buildAnsweredStatement} (verb = ANSWERED). */\nexport interface AnsweredStatementParams {\n  actor: XAPIActor;\n  object: XAPIObjectParams;\n  scoringResult: ScoringResult;\n  timeSpentMs: number;\n  /** Serialized learner response string. */\n  response?: string;\n  context?: XAPIContext;\n  resultExtensions?: Record<string, unknown>;\n}\n\n/**\n * Parameters for {@link xAPIBuilder.buildSubmittedStatement} (verb =\n * SUBMITTED — deferred-grading submissions). Carries NO score, success, or\n * completion: the grade does not exist yet (Req 22.7).\n */\nexport interface SubmittedStatementParams {\n  actor: XAPIActor;\n  object: XAPIObjectParams;\n  timeSpentMs: number;\n  /** Serialized learner response string (e.g. the submitted text). */\n  response?: string;\n  context?: XAPIContext;\n  resultExtensions?: Record<string, unknown>;\n}\n\n/** Parameters for {@link xAPIBuilder.buildCompletedStatement} (verb = COMPLETED). */\nexport interface CompletedStatementParams {\n  actor: XAPIActor;\n  object: XAPIObjectParams;\n  scoringResult?: ScoringResult;\n  timeSpentMs: number;\n  context?: XAPIContext;\n  resultExtensions?: Record<string, unknown>;\n}\n\n/**\n * Converts a millisecond duration to an ISO 8601 seconds string with\n * centisecond precision (`PT1.23S`), per the xAPI 1.0.3 recommendation of\n * 0.01-second accuracy. Sub-second durations are preserved (previously any\n * duration under 500 ms collapsed to `PT0S`). Negative inputs (clock skew)\n * clamp to zero — a negative ISO duration is invalid.\n */\nfunction msToIsoDuration(ms: number): string {\n  return `PT${(Math.round(Math.max(0, ms) / 10) / 100).toFixed(2)}S`;\n}\n\n/**\n * UUID v4 that works outside secure contexts. `crypto.randomUUID` is\n * SecureContext-gated (undefined on plain-http LAN/staging origins), and a\n * statement is built at SUBMIT time — throwing here would lose the learner's\n * answer. `crypto.getRandomValues` is NOT gated, so the fallback still emits\n * a spec-valid v4 UUID (the statement validator enforces the v4 format).\n */\nfunction uuidv4(): string {\n  const c = (\n    globalThis as {\n      crypto?: { randomUUID?: () => string; getRandomValues?: (a: Uint8Array) => Uint8Array };\n    }\n  ).crypto;\n  if (c?.randomUUID) {\n    return c.randomUUID();\n  }\n  const bytes = new Uint8Array(16);\n  if (c?.getRandomValues) {\n    c.getRandomValues(bytes);\n  } else {\n    for (let i = 0; i < 16; i += 1) {\n      bytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n  bytes[6] = ((bytes[6] as number) & 0x0f) | 0x40;\n  bytes[8] = ((bytes[8] as number) & 0x3f) | 0x80;\n  const hex = [...bytes].map((b) => b.toString(16).padStart(2, '0')).join('');\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n\n/** Builds the xAPI Activity object, including `definition` only when populated. */\nfunction buildObject(params: XAPIObjectParams): XAPIObject {\n  const definition: NonNullable<XAPIObject['definition']> = {\n    ...(params.name !== undefined ? { name: params.name } : {}),\n    ...(params.description !== undefined ? { description: params.description } : {}),\n    ...(params.type !== undefined ? { type: params.type } : {}),\n    ...(params.interactionType !== undefined ? { interactionType: params.interactionType } : {}),\n    ...(params.correctResponsesPattern !== undefined\n      ? { correctResponsesPattern: params.correctResponsesPattern }\n      : {}),\n    ...(params.choices !== undefined ? { choices: params.choices } : {}),\n  };\n  return {\n    objectType: 'Activity',\n    id: params.id,\n    ...(Object.keys(definition).length > 0 ? { definition } : {}),\n  };\n}\n\n/**\n * Maps a {@link ScoringResult} + timing to an {@link XAPIResult} per the\n * normative mapping in the design document.\n */\nfunction buildResult(\n  timeSpentMs: number,\n  scoringResult: ScoringResult | undefined,\n  resultExtensions: Record<string, unknown> | undefined,\n  response: string | undefined,\n): XAPIResult {\n  return {\n    completion: true,\n    duration: msToIsoDuration(timeSpentMs),\n    ...(scoringResult !== undefined\n      ? {\n          score: {\n            scaled: scoringResult.score,\n            raw: scoringResult.score,\n            min: 0,\n            max: scoringResult.maxScore,\n          },\n          success: scoringResult.passed,\n        }\n      : {}),\n    ...(response !== undefined ? { response } : {}),\n    ...(resultExtensions !== undefined ? { extensions: resultExtensions } : {}),\n  };\n}\n\n/**\n * Constructs xAPI 1.0.3 Statements. Every call stamps a fresh UUID v4 `id`,\n * an ISO 8601 `timestamp`, and `version: '1.0.3'`. Not pure by design —\n * statements are unique events.\n */\nexport const xAPIBuilder = {\n  buildStatement(params: XAPIStatementParams): XAPIStatement {\n    const statement: XAPIStatement = {\n      id: uuidv4(),\n      actor: params.actor,\n      verb: {\n        id: XAPIVerb[params.verb],\n        display: XAPI_VERB_DISPLAY[params.verb],\n      },\n      object: buildObject(params.object),\n      ...(params.result !== undefined ? { result: params.result } : {}),\n      ...(params.context !== undefined ? { context: params.context } : {}),\n      timestamp: new Date().toISOString(),\n      version: '1.0.3',\n    };\n    // Design xAPIBuilder step 4: validate every statement (throws in dev,\n    // warns in prod). All build*Statement helpers route through here.\n    validateXAPIStatement(statement);\n    return statement;\n  },\n\n  buildAnsweredStatement(params: AnsweredStatementParams): XAPIStatement {\n    return this.buildStatement({\n      actor: params.actor,\n      verb: 'ANSWERED',\n      object: params.object,\n      result: buildResult(\n        params.timeSpentMs,\n        params.scoringResult,\n        params.resultExtensions,\n        params.response,\n      ),\n      ...(params.context !== undefined ? { context: params.context } : {}),\n    });\n  },\n\n  /**\n   * Builds a statement for a deferred-grading submission (e.g. a written\n   * response). Verb is SUBMITTED and the result deliberately omits `score`,\n   * `success`, and `completion` — none of them exist until the asynchronous\n   * grader runs; only `duration`, `response`, and extensions are recorded.\n   */\n  buildSubmittedStatement(params: SubmittedStatementParams): XAPIStatement {\n    return this.buildStatement({\n      actor: params.actor,\n      verb: 'SUBMITTED',\n      object: params.object,\n      result: {\n        duration: msToIsoDuration(params.timeSpentMs),\n        ...(params.response !== undefined ? { response: params.response } : {}),\n        ...(params.resultExtensions !== undefined ? { extensions: params.resultExtensions } : {}),\n      },\n      ...(params.context !== undefined ? { context: params.context } : {}),\n    });\n  },\n\n  buildCompletedStatement(params: CompletedStatementParams): XAPIStatement {\n    return this.buildStatement({\n      actor: params.actor,\n      verb: 'COMPLETED',\n      object: params.object,\n      result: buildResult(\n        params.timeSpentMs,\n        params.scoringResult,\n        params.resultExtensions,\n        undefined,\n      ),\n      ...(params.context !== undefined ? { context: params.context } : {}),\n    });\n  },\n};\n"],"mappings":"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","names":[]}