@intellectif/lk-core 1.4.0 → 1.5.0

package/dist/scoring.d.ts

@@ -1,3 +1,3 @@
-import { Ht as ItemOutcome, Mn as TextMatchResult, Nn as levenshteinDistance, Pn as matchText, Qt as ReadAloudData, Tn as GradeRecord, in as RecordingRef, jn as TextMatchPolicy, tn as ReadAloudLearnerResponse } from "./ai-CnmLPMzd.js";
-import { $ as SpeechAssessment, A as diffDictationChars, B as ItemTry, C as validateItemScoringPolicy, D as DICTATION_MAX_TEXT_LENGTH, E as DICTATION_MAX_EQUIVALENCE_LENGTH, F as dictationReferenceWords, G as CompositionPolicy, H as ResolvedItemScoringPolicy, I as ItemScoringCount, J as SectionScore, K as PassFailureReason, L as ItemScoringPolicy, M as DictationReference, N as DictationWordAlignment, O as DICTATION_MAX_TRANSCRIPT_LENGTH, P as alignDictation, Q as ReadAloudWordState, R as ItemScoringPolicyIssue, S as scoreTries, T as DICTATION_MAX_EQUIVALENCES, U as AssessmentScore, V as ItemTryScore, W as AssessmentSectionInput, X as GradeReadAloudOptions, Y as composeAssessmentScore, Z as ReadAloudWordAlignment, _ as DEFAULT_PASS_THRESHOLD, a as evaluateTries, at as SpeechUnscorable, b as ITEM_SCORING_MAX_RETRIES, c as inspectWav, ct as SpeechWordError, d as READ_ALOUD_MAX_SECONDS, dt as Band, et as SpeechMeasurement, f as READ_ALOUD_MAX_TAKES, ft as RoundingMode, g as alignReadAloud, gt as roundGrade, h as validateSpeechAssessment, ht as gte, i as evaluate, it as SpeechSyllable, j as DictationAlignment, k as DictationCharOp, l as READ_ALOUD_MAX_DIMENSION_WEIGHT, lt as WavInspection, m as gradeReadAloud, mt as classifyBand, n as ItemTriesOutcome, nt as SpeechPhonemeCandidate, o as score, ot as SpeechUnscorableCode, p as SPEECH_ASSESSMENT_MAX_WORDS, pt as RoundingPolicy, q as ScoredItem, r as ScoringOptions, rt as SpeechPlausibilityPolicy, s as outcomeFromUnscorable, st as SpeechWord, t as EvaluateOptions, tt as SpeechPhoneme, u as READ_ALOUD_MAX_REFERENCE_LENGTH, ut as WavInspectionPolicy, v as computePassThreshold, w as DICTATION_MAX_ACCEPTED_TRANSCRIPTS, x as resolveItemScoringPolicy, y as DEFAULT_ITEM_SCORING_POLICY, z as ItemTriesScore } from "./index-CVWvymVb.js";
-export { type AssessmentScore, type AssessmentSectionInput, type Band, type CompositionPolicy, DEFAULT_ITEM_SCORING_POLICY, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, type DictationAlignment, type DictationCharOp, type DictationReference, type DictationWordAlignment, EvaluateOptions, type GradeReadAloudOptions, type GradeRecord, ITEM_SCORING_MAX_RETRIES, type ItemOutcome, type ItemScoringCount, type ItemScoringPolicy, type ItemScoringPolicyIssue, ItemTriesOutcome, type ItemTriesScore, type ItemTry, type ItemTryScore, type PassFailureReason, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, type ReadAloudData, type ReadAloudLearnerResponse, type ReadAloudWordAlignment, type ReadAloudWordState, type RecordingRef, type ResolvedItemScoringPolicy, type RoundingMode, type RoundingPolicy, SPEECH_ASSESSMENT_MAX_WORDS, type ScoredItem, ScoringOptions, type SectionScore, type SpeechAssessment, type SpeechMeasurement, type SpeechPhoneme, type SpeechPhonemeCandidate, type SpeechPlausibilityPolicy, type SpeechSyllable, type SpeechUnscorable, type SpeechUnscorableCode, type SpeechWord, type SpeechWordError, type TextMatchPolicy, type TextMatchResult, type WavInspection, type WavInspectionPolicy, alignDictation, alignReadAloud, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, evaluateTries, gradeReadAloud, gte, inspectWav, levenshteinDistance, matchText, outcomeFromUnscorable, resolveItemScoringPolicy, roundGrade, score, scoreTries, validateItemScoringPolicy, validateSpeechAssessment };
+import { Hn as TextMatchResult, Jt as ItemOutcome, Mn as GradeRecord, Un as levenshteinDistance, Vn as TextMatchPolicy, Wn as matchText, in as ReadAloudData, sn as ReadAloudLearnerResponse, un as RecordingRef } from "./ai-BYryFkF9.js";
+import { A as diffDictationChars, At as Band, B as outcomeFromRoutedGrade, C as validateItemScoringPolicy, Ct as SpeechSyllable, D as DICTATION_MAX_TEXT_LENGTH, Dt as SpeechWordError, E as DICTATION_MAX_EQUIVALENCE_LENGTH, Et as SpeechWord, F as dictationReferenceWords, Ft as roundGrade, G as CalibrationReport, H as GradeFromJudgementOptions, I as CalibrationThresholds, J as TotalCalibration, K as CalibrationScope, L as GradeRoutingContext, M as DictationReference, Mt as RoundingPolicy, N as DictationWordAlignment, Nt as classifyBand, O as DICTATION_MAX_TRANSCRIPT_LENGTH, Ot as WavInspection, P as alignDictation, Pt as gte, R as GradeRoutingPolicy, S as scoreTries, St as SpeechPlausibilityPolicy, T as DICTATION_MAX_EQUIVALENCES, Tt as SpeechUnscorableCode, U as gradeFromJudgement, V as routeGrade, W as CalibrationPair, X as graderConfiguration, Y as calibrationReport, _ as DEFAULT_PASS_THRESHOLD, _t as ReadAloudWordState, a as evaluateTries, at as ItemTry, b as ITEM_SCORING_MAX_RETRIES, bt as SpeechPhoneme, c as inspectWav, ct as AssessmentScore, d as READ_ALOUD_MAX_SECONDS, dt as PassFailureReason, f as READ_ALOUD_MAX_TAKES, ft as ScoredItem, g as alignReadAloud, gt as ReadAloudWordAlignment, h as validateSpeechAssessment, ht as GradeReadAloudOptions, i as evaluate, it as ItemTriesScore, j as DictationAlignment, jt as RoundingMode, k as DictationCharOp, kt as WavInspectionPolicy, l as READ_ALOUD_MAX_DIMENSION_WEIGHT, lt as AssessmentSectionInput, m as gradeReadAloud, mt as composeAssessmentScore, n as ItemTriesOutcome, nt as ItemScoringPolicy, o as score, ot as ItemTryScore, p as SPEECH_ASSESSMENT_MAX_WORDS, pt as SectionScore, q as CriterionCalibration, r as ScoringOptions, rt as ItemScoringPolicyIssue, s as outcomeFromUnscorable, st as ResolvedItemScoringPolicy, t as EvaluateOptions, tt as ItemScoringCount, u as READ_ALOUD_MAX_REFERENCE_LENGTH, ut as CompositionPolicy, v as computePassThreshold, vt as SpeechAssessment, w as DICTATION_MAX_ACCEPTED_TRANSCRIPTS, wt as SpeechUnscorable, x as resolveItemScoringPolicy, xt as SpeechPhonemeCandidate, y as DEFAULT_ITEM_SCORING_POLICY, yt as SpeechMeasurement, z as inAuditSample } from "./index-DUaW1Tj5.js";
+export { type AssessmentScore, type AssessmentSectionInput, type Band, type CalibrationPair, type CalibrationReport, type CalibrationScope, type CalibrationThresholds, type CompositionPolicy, type CriterionCalibration, DEFAULT_ITEM_SCORING_POLICY, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, type DictationAlignment, type DictationCharOp, type DictationReference, type DictationWordAlignment, EvaluateOptions, type GradeFromJudgementOptions, type GradeReadAloudOptions, type GradeRecord, type GradeRoutingContext, type GradeRoutingPolicy, ITEM_SCORING_MAX_RETRIES, type ItemOutcome, type ItemScoringCount, type ItemScoringPolicy, type ItemScoringPolicyIssue, ItemTriesOutcome, type ItemTriesScore, type ItemTry, type ItemTryScore, type PassFailureReason, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, type ReadAloudData, type ReadAloudLearnerResponse, type ReadAloudWordAlignment, type ReadAloudWordState, type RecordingRef, type ResolvedItemScoringPolicy, type RoundingMode, type RoundingPolicy, SPEECH_ASSESSMENT_MAX_WORDS, type ScoredItem, ScoringOptions, type SectionScore, type SpeechAssessment, type SpeechMeasurement, type SpeechPhoneme, type SpeechPhonemeCandidate, type SpeechPlausibilityPolicy, type SpeechSyllable, type SpeechUnscorable, type SpeechUnscorableCode, type SpeechWord, type SpeechWordError, type TextMatchPolicy, type TextMatchResult, type TotalCalibration, type WavInspection, type WavInspectionPolicy, alignDictation, alignReadAloud, calibrationReport, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, evaluateTries, gradeFromJudgement, gradeReadAloud, graderConfiguration, gte, inAuditSample, inspectWav, levenshteinDistance, matchText, outcomeFromRoutedGrade, outcomeFromUnscorable, resolveItemScoringPolicy, roundGrade, routeGrade, score, scoreTries, validateItemScoringPolicy, validateSpeechAssessment };

package/dist/scoring.js

@@ -1,3 +1,3 @@
-import { $ as dictationReferenceWords, A as matchText, S as READ_ALOUD_MAX_TAKES, Z as alignDictation, b as READ_ALOUD_MAX_REFERENCE_LENGTH, et as DICTATION_MAX_ACCEPTED_TRANSCRIPTS, it as DICTATION_MAX_TRANSCRIPT_LENGTH, k as levenshteinDistance, nt as DICTATION_MAX_EQUIVALENCE_LENGTH, rt as DICTATION_MAX_TEXT_LENGTH, tt as DICTATION_MAX_EQUIVALENCES, w as SPEECH_ASSESSMENT_MAX_WORDS, x as READ_ALOUD_MAX_SECONDS, y as READ_ALOUD_MAX_DIMENSION_WEIGHT } from "./registry-Dsx9mNsS.js";
-import { C as validateItemScoringPolicy, S as scoreTries, _ as gte, a as inspectWav, b as ITEM_SCORING_MAX_RETRIES, c as validateSpeechAssessment, g as classifyBand, h as computePassThreshold, i as outcomeFromUnscorable, l as diffDictationChars, m as DEFAULT_PASS_THRESHOLD, n as evaluateTries, o as gradeReadAloud, r as score, s as alignReadAloud, t as evaluate, u as composeAssessmentScore, v as roundGrade, x as resolveItemScoringPolicy, y as DEFAULT_ITEM_SCORING_POLICY } from "./scoring-BZqUkuDF.js";
-export { DEFAULT_ITEM_SCORING_POLICY, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, ITEM_SCORING_MAX_RETRIES, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, SPEECH_ASSESSMENT_MAX_WORDS, alignDictation, alignReadAloud, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, evaluateTries, gradeReadAloud, gte, inspectWav, levenshteinDistance, matchText, outcomeFromUnscorable, resolveItemScoringPolicy, roundGrade, score, scoreTries, validateItemScoringPolicy, validateSpeechAssessment };
+import { A as levenshteinDistance, C as READ_ALOUD_MAX_TAKES, S as READ_ALOUD_MAX_SECONDS, T as SPEECH_ASSESSMENT_MAX_WORDS, at as DICTATION_MAX_ACCEPTED_TRANSCRIPTS, b as READ_ALOUD_MAX_DIMENSION_WEIGHT, ct as DICTATION_MAX_TEXT_LENGTH, it as dictationReferenceWords, j as matchText, lt as DICTATION_MAX_TRANSCRIPT_LENGTH, nt as alignDictation, ot as DICTATION_MAX_EQUIVALENCES, st as DICTATION_MAX_EQUIVALENCE_LENGTH, x as READ_ALOUD_MAX_REFERENCE_LENGTH } from "./registry-DaZRpqjW.js";
+import { A as DEFAULT_ITEM_SCORING_POLICY, D as classifyBand, E as computePassThreshold, M as resolveItemScoringPolicy, N as scoreTries, O as gte, P as validateItemScoringPolicy, T as DEFAULT_PASS_THRESHOLD, a as inspectWav, b as calibrationReport, c as validateSpeechAssessment, d as inAuditSample, f as outcomeFromRoutedGrade, g as gradeFromJudgement, i as outcomeFromUnscorable, j as ITEM_SCORING_MAX_RETRIES, k as roundGrade, l as diffDictationChars, n as evaluateTries, o as gradeReadAloud, p as routeGrade, r as score, s as alignReadAloud, t as evaluate, u as composeAssessmentScore, x as graderConfiguration } from "./scoring-BKNNTz-s.js";
+export { DEFAULT_ITEM_SCORING_POLICY, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, ITEM_SCORING_MAX_RETRIES, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, SPEECH_ASSESSMENT_MAX_WORDS, alignDictation, alignReadAloud, calibrationReport, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, evaluateTries, gradeFromJudgement, gradeReadAloud, graderConfiguration, gte, inAuditSample, inspectWav, levenshteinDistance, matchText, outcomeFromRoutedGrade, outcomeFromUnscorable, resolveItemScoringPolicy, roundGrade, routeGrade, score, scoreTries, validateItemScoringPolicy, validateSpeechAssessment };

package/dist/{xapi-DNzkSJ0S.cjs → xapi-NYrTlpID.cjs}

@@ -1,4 +1,4 @@
-const require_registry = require("./registry-DVi0LR_i.cjs");
+const require_registry = require("./registry-Ce00A_OW.cjs");
 let zod_v4 = require("zod/v4");
 zod_v4 = require_registry.__toESM(zod_v4, 1);
 //#region src/xapi/validators.ts
@@ -359,4 +359,4 @@ Object.defineProperty(exports, "xapiDefinitionFor", {
 	}
 });
 
-//# sourceMappingURL=xapi-DNzkSJ0S.cjs.map
+//# sourceMappingURL=xapi-NYrTlpID.cjs.map

package/dist/{xapi-DNzkSJ0S.cjs.map → xapi-NYrTlpID.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"xapi-DNzkSJ0S.cjs","names":["z","ActivitySchemaError","getActivityTypeDescriptor"],"sources":["../src/xapi/validators.ts","../src/xapi/verbs.ts","../src/xapi/builder.ts"],"sourcesContent":["import * as 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/**\n * The one global this module reads by name. Declared here, not globally: this\n * package compiles without Node's types on purpose, and nothing else in it may\n * come to rely on `process`.\n */\ndeclare const process: { env: { NODE_ENV?: string } };\n\n/**\n * Whether this is a production build.\n *\n * **The literal `process.env.NODE_ENV`, spelled exactly so.** It is the one\n * expression bundlers replace at build time, and a browser has no `process` to\n * read at run time. The reading this replaces,\n * `globalThis.process?.env?.NODE_ENV`, is not that expression, so no bundler\n * touched it, and in a browser it found no `process` and answered \"not\n * production\" in every production app — so a malformed statement threw there\n * instead of being logged and sent. Tests running in Node never saw it,\n * because Node has a `process`.\n *\n * This package's own build must leave the literal in its output, for the\n * consumer's bundler to replace. The `try` covers code that reaches a runtime\n * unbundled, with no `process` at all: that is not production, as it always\n * was.\n */\nfunction isProduction(): boolean {\n  try {\n    return process.env.NODE_ENV === 'production';\n  } catch {\n    return false;\n  }\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.\n   */\n  SUBMITTED: 'http://activitystrea.ms/schema/1.0/submit',\n  /**\n   * Emitted when an asynchronous grader produces a grade for work that was\n   * previously only SUBMITTED. Distinct from `answered`, which asserts the\n   * grade existed at submission time — here the learner acted earlier and the\n   * grade arrived later, often from a different actor (an AI or a teacher).\n   */\n  SCORED: 'http://adlnet.gov/expapi/verbs/scored',\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  SCORED: { 'en-US': 'scored' },\n};\n","import { getActivityTypeDescriptor } from '../registry/index.js';\nimport 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.\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\n/**\n * Builds the xAPI `object.definition` interop fields for an activity from its\n * REGISTERED descriptor, rather than having every renderer hand-roll them.\n *\n * `ActivityTypeDescriptor.interop` declares the activity-type IRI, the\n * cmi.interaction type and how to derive `correctResponsesPattern`; before\n * this, those fields had no reader anywhere and each component rebuilt the\n * same strings inline — the same \"declared but never used\" defect the SDK\n * fixed elsewhere. Reading them here also means a consumer-registered type\n * gets correct interop for free.\n *\n * Returns an empty object for an unregistered type or one that declares no\n * interop, so it is always safe to spread.\n */\nexport function xapiDefinitionFor(data: { type: string }): Partial<XAPIObjectParams> {\n  const descriptor = getActivityTypeDescriptor(data.type);\n  const interop = descriptor?.interop;\n  if (interop === undefined) {\n    return {};\n  }\n  const pattern = interop.correctResponsesPattern?.(data);\n  return {\n    ...(interop.xapiActivityTypeIri !== undefined ? { type: interop.xapiActivityTypeIri } : {}),\n    ...(interop.xapiInteractionType !== undefined\n      ? { interactionType: interop.xapiInteractionType }\n      : {}),\n    ...(pattern !== undefined && pattern.length > 0 ? { correctResponsesPattern: pattern } : {}),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"xapi-NYrTlpID.cjs","names":["z","ActivitySchemaError","getActivityTypeDescriptor"],"sources":["../src/xapi/validators.ts","../src/xapi/verbs.ts","../src/xapi/builder.ts"],"sourcesContent":["import * as 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/**\n * The one global this module reads by name. Declared here, not globally: this\n * package compiles without Node's types on purpose, and nothing else in it may\n * come to rely on `process`.\n */\ndeclare const process: { env: { NODE_ENV?: string } };\n\n/**\n * Whether this is a production build.\n *\n * **The literal `process.env.NODE_ENV`, spelled exactly so.** It is the one\n * expression bundlers replace at build time, and a browser has no `process` to\n * read at run time. The reading this replaces,\n * `globalThis.process?.env?.NODE_ENV`, is not that expression, so no bundler\n * touched it, and in a browser it found no `process` and answered \"not\n * production\" in every production app — so a malformed statement threw there\n * instead of being logged and sent. Tests running in Node never saw it,\n * because Node has a `process`.\n *\n * This package's own build must leave the literal in its output, for the\n * consumer's bundler to replace. The `try` covers code that reaches a runtime\n * unbundled, with no `process` at all: that is not production, as it always\n * was.\n */\nfunction isProduction(): boolean {\n  try {\n    return process.env.NODE_ENV === 'production';\n  } catch {\n    return false;\n  }\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.\n   */\n  SUBMITTED: 'http://activitystrea.ms/schema/1.0/submit',\n  /**\n   * Emitted when an asynchronous grader produces a grade for work that was\n   * previously only SUBMITTED. Distinct from `answered`, which asserts the\n   * grade existed at submission time — here the learner acted earlier and the\n   * grade arrived later, often from a different actor (an AI or a teacher).\n   */\n  SCORED: 'http://adlnet.gov/expapi/verbs/scored',\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  SCORED: { 'en-US': 'scored' },\n};\n","import { getActivityTypeDescriptor } from '../registry/index.js';\nimport 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.\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\n/**\n * Builds the xAPI `object.definition` interop fields for an activity from its\n * REGISTERED descriptor, rather than having every renderer hand-roll them.\n *\n * `ActivityTypeDescriptor.interop` declares the activity-type IRI, the\n * cmi.interaction type and how to derive `correctResponsesPattern`; before\n * this, those fields had no reader anywhere and each component rebuilt the\n * same strings inline — the same \"declared but never used\" defect the SDK\n * fixed elsewhere. Reading them here also means a consumer-registered type\n * gets correct interop for free.\n *\n * Returns an empty object for an unregistered type or one that declares no\n * interop, so it is always safe to spread.\n */\nexport function xapiDefinitionFor(data: { type: string }): Partial<XAPIObjectParams> {\n  const descriptor = getActivityTypeDescriptor(data.type);\n  const interop = descriptor?.interop;\n  if (interop === undefined) {\n    return {};\n  }\n  const pattern = interop.correctResponsesPattern?.(data);\n  return {\n    ...(interop.xapiActivityTypeIri !== undefined ? { type: interop.xapiActivityTypeIri } : {}),\n    ...(interop.xapiInteractionType !== undefined\n      ? { interactionType: interop.xapiInteractionType }\n      : {}),\n    ...(pattern !== undefined && pattern.length > 0 ? { correctResponsesPattern: pattern } : {}),\n  };\n}\n"],"mappings":"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"}

package/dist/{xapi-CMTph7wG.js → xapi-wR6gu4qS.js}

@@ -1,4 +1,4 @@
-import { K as ActivitySchemaError, t as getActivityTypeDescriptor } from "./registry-Dsx9mNsS.js";
+import { Z as ActivitySchemaError, t as getActivityTypeDescriptor } from "./registry-DaZRpqjW.js";
 import * as z from "zod/v4";
 //#region src/xapi/validators.ts
 const 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;
@@ -329,4 +329,4 @@ function xapiDefinitionFor(data) {
 //#endregion
 export { validateXAPIStatement as a, XAPI_VERB_DISPLAY as i, xapiDefinitionFor as n, XAPIVerb as r, xAPIBuilder as t };
 
-//# sourceMappingURL=xapi-CMTph7wG.js.map
+//# sourceMappingURL=xapi-wR6gu4qS.js.map

package/dist/{xapi-CMTph7wG.js.map → xapi-wR6gu4qS.js.map}

@@ -1 +1 @@
-{"version":3,"file":"xapi-CMTph7wG.js","names":[],"sources":["../src/xapi/validators.ts","../src/xapi/verbs.ts","../src/xapi/builder.ts"],"sourcesContent":["import * as 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/**\n * The one global this module reads by name. Declared here, not globally: this\n * package compiles without Node's types on purpose, and nothing else in it may\n * come to rely on `process`.\n */\ndeclare const process: { env: { NODE_ENV?: string } };\n\n/**\n * Whether this is a production build.\n *\n * **The literal `process.env.NODE_ENV`, spelled exactly so.** It is the one\n * expression bundlers replace at build time, and a browser has no `process` to\n * read at run time. The reading this replaces,\n * `globalThis.process?.env?.NODE_ENV`, is not that expression, so no bundler\n * touched it, and in a browser it found no `process` and answered \"not\n * production\" in every production app — so a malformed statement threw there\n * instead of being logged and sent. Tests running in Node never saw it,\n * because Node has a `process`.\n *\n * This package's own build must leave the literal in its output, for the\n * consumer's bundler to replace. The `try` covers code that reaches a runtime\n * unbundled, with no `process` at all: that is not production, as it always\n * was.\n */\nfunction isProduction(): boolean {\n  try {\n    return process.env.NODE_ENV === 'production';\n  } catch {\n    return false;\n  }\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.\n   */\n  SUBMITTED: 'http://activitystrea.ms/schema/1.0/submit',\n  /**\n   * Emitted when an asynchronous grader produces a grade for work that was\n   * previously only SUBMITTED. Distinct from `answered`, which asserts the\n   * grade existed at submission time — here the learner acted earlier and the\n   * grade arrived later, often from a different actor (an AI or a teacher).\n   */\n  SCORED: 'http://adlnet.gov/expapi/verbs/scored',\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  SCORED: { 'en-US': 'scored' },\n};\n","import { getActivityTypeDescriptor } from '../registry/index.js';\nimport 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.\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\n/**\n * Builds the xAPI `object.definition` interop fields for an activity from its\n * REGISTERED descriptor, rather than having every renderer hand-roll them.\n *\n * `ActivityTypeDescriptor.interop` declares the activity-type IRI, the\n * cmi.interaction type and how to derive `correctResponsesPattern`; before\n * this, those fields had no reader anywhere and each component rebuilt the\n * same strings inline — the same \"declared but never used\" defect the SDK\n * fixed elsewhere. Reading them here also means a consumer-registered type\n * gets correct interop for free.\n *\n * Returns an empty object for an unregistered type or one that declares no\n * interop, so it is always safe to spread.\n */\nexport function xapiDefinitionFor(data: { type: string }): Partial<XAPIObjectParams> {\n  const descriptor = getActivityTypeDescriptor(data.type);\n  const interop = descriptor?.interop;\n  if (interop === undefined) {\n    return {};\n  }\n  const pattern = interop.correctResponsesPattern?.(data);\n  return {\n    ...(interop.xapiActivityTypeIri !== undefined ? { type: interop.xapiActivityTypeIri } : {}),\n    ...(interop.xapiInteractionType !== undefined\n      ? { interactionType: interop.xapiInteractionType }\n      : {}),\n    ...(pattern !== undefined && pattern.length > 0 ? { correctResponsesPattern: pattern } : {}),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"xapi-wR6gu4qS.js","names":[],"sources":["../src/xapi/validators.ts","../src/xapi/verbs.ts","../src/xapi/builder.ts"],"sourcesContent":["import * as 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/**\n * The one global this module reads by name. Declared here, not globally: this\n * package compiles without Node's types on purpose, and nothing else in it may\n * come to rely on `process`.\n */\ndeclare const process: { env: { NODE_ENV?: string } };\n\n/**\n * Whether this is a production build.\n *\n * **The literal `process.env.NODE_ENV`, spelled exactly so.** It is the one\n * expression bundlers replace at build time, and a browser has no `process` to\n * read at run time. The reading this replaces,\n * `globalThis.process?.env?.NODE_ENV`, is not that expression, so no bundler\n * touched it, and in a browser it found no `process` and answered \"not\n * production\" in every production app — so a malformed statement threw there\n * instead of being logged and sent. Tests running in Node never saw it,\n * because Node has a `process`.\n *\n * This package's own build must leave the literal in its output, for the\n * consumer's bundler to replace. The `try` covers code that reaches a runtime\n * unbundled, with no `process` at all: that is not production, as it always\n * was.\n */\nfunction isProduction(): boolean {\n  try {\n    return process.env.NODE_ENV === 'production';\n  } catch {\n    return false;\n  }\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.\n   */\n  SUBMITTED: 'http://activitystrea.ms/schema/1.0/submit',\n  /**\n   * Emitted when an asynchronous grader produces a grade for work that was\n   * previously only SUBMITTED. Distinct from `answered`, which asserts the\n   * grade existed at submission time — here the learner acted earlier and the\n   * grade arrived later, often from a different actor (an AI or a teacher).\n   */\n  SCORED: 'http://adlnet.gov/expapi/verbs/scored',\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  SCORED: { 'en-US': 'scored' },\n};\n","import { getActivityTypeDescriptor } from '../registry/index.js';\nimport 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.\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\n/**\n * Builds the xAPI `object.definition` interop fields for an activity from its\n * REGISTERED descriptor, rather than having every renderer hand-roll them.\n *\n * `ActivityTypeDescriptor.interop` declares the activity-type IRI, the\n * cmi.interaction type and how to derive `correctResponsesPattern`; before\n * this, those fields had no reader anywhere and each component rebuilt the\n * same strings inline — the same \"declared but never used\" defect the SDK\n * fixed elsewhere. Reading them here also means a consumer-registered type\n * gets correct interop for free.\n *\n * Returns an empty object for an unregistered type or one that declares no\n * interop, so it is always safe to spread.\n */\nexport function xapiDefinitionFor(data: { type: string }): Partial<XAPIObjectParams> {\n  const descriptor = getActivityTypeDescriptor(data.type);\n  const interop = descriptor?.interop;\n  if (interop === undefined) {\n    return {};\n  }\n  const pattern = interop.correctResponsesPattern?.(data);\n  return {\n    ...(interop.xapiActivityTypeIri !== undefined ? { type: interop.xapiActivityTypeIri } : {}),\n    ...(interop.xapiInteractionType !== undefined\n      ? { interactionType: interop.xapiInteractionType }\n      : {}),\n    ...(pattern !== undefined && pattern.length > 0 ? { correctResponsesPattern: pattern } : {}),\n  };\n}\n"],"mappings":"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"}

package/dist/xapi.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_xapi = require("./xapi-DNzkSJ0S.cjs");
+const require_xapi = require("./xapi-NYrTlpID.cjs");
 exports.XAPIVerb = require_xapi.XAPIVerb;
 exports.XAPI_VERB_DISPLAY = require_xapi.XAPI_VERB_DISPLAY;
 exports.validateXAPIStatement = require_xapi.validateXAPIStatement;

package/dist/xapi.d.cts

@@ -1,2 +1,2 @@
-import { a as XAPIObjectParams, c as xapiDefinitionFor, d as XAPI_VERB_DISPLAY, i as SubmittedStatementParams, l as XAPIVerb, n as AnsweredStatementParams, o as XAPIStatementParams, r as CompletedStatementParams, s as xAPIBuilder, t as validateXAPIStatement, u as XAPIVerbKey } from "./index-BqMXWuNC.cjs";
+import { a as XAPIObjectParams, c as xapiDefinitionFor, d as XAPI_VERB_DISPLAY, i as SubmittedStatementParams, l as XAPIVerb, n as AnsweredStatementParams, o as XAPIStatementParams, r as CompletedStatementParams, s as xAPIBuilder, t as validateXAPIStatement, u as XAPIVerbKey } from "./index-D7R3Ll8R.cjs";
 export { type AnsweredStatementParams, type CompletedStatementParams, type SubmittedStatementParams, type XAPIObjectParams, type XAPIStatementParams, XAPIVerb, type XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor };

package/dist/xapi.d.ts

@@ -1,2 +1,2 @@
-import { a as XAPIObjectParams, c as xapiDefinitionFor, d as XAPI_VERB_DISPLAY, i as SubmittedStatementParams, l as XAPIVerb, n as AnsweredStatementParams, o as XAPIStatementParams, r as CompletedStatementParams, s as xAPIBuilder, t as validateXAPIStatement, u as XAPIVerbKey } from "./index-CcHDTxIZ.js";
+import { a as XAPIObjectParams, c as xapiDefinitionFor, d as XAPI_VERB_DISPLAY, i as SubmittedStatementParams, l as XAPIVerb, n as AnsweredStatementParams, o as XAPIStatementParams, r as CompletedStatementParams, s as xAPIBuilder, t as validateXAPIStatement, u as XAPIVerbKey } from "./index-wMc1E_aM.js";
 export { type AnsweredStatementParams, type CompletedStatementParams, type SubmittedStatementParams, type XAPIObjectParams, type XAPIStatementParams, XAPIVerb, type XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor };

package/dist/xapi.js

@@ -1,2 +1 @@
-import { a as validateXAPIStatement, i as XAPI_VERB_DISPLAY, n as xapiDefinitionFor, r as XAPIVerb, t as xAPIBuilder } from "./xapi-CMTph7wG.js";
-export { XAPIVerb, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor };
+export { r as XAPIVerb, i as XAPI_VERB_DISPLAY, a as validateXAPIStatement, t as xAPIBuilder, n as xapiDefinitionFor } from "./xapi-wR6gu4qS.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellectif/lk-core",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Framework-free assessment core: activity validation, pure scoring, rubric & deferred grading, weighted assessment composition, exam attempt plans, and xAPI 1.0.3. Custom activity types take any Standard Schema.",
   "keywords": [
     "assessment",
@@ -96,7 +96,7 @@
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.6",
     "fast-check": "^4.10.2",
-    "tsdown": "0.23.0",
+    "tsdown": "0.23.1",
     "vitest": "^4.1.6"
   },
   "license": "MIT",

package/vectors/README.md

@@ -143,7 +143,26 @@ a known hazard carry a `note` saying why they exist.
   when an outcome is missing, and **`composeAssessmentScore`** across weights,
   points, provisional, rejected and unscorable items, and section thresholds —
   including the outcomes earlier releases stored for a grade that was never
-  one, which now hold a result provisional instead of finalising it.
+  one, which now hold a result provisional instead of finalising it, and a grade
+  held for a person (`awaiting_human_review`), which does too.
+- **Assisted grading.**
+  - **`gradeFromJudgement`**: the total from a model's checked judgement with
+    the rubric's own weights, a level scored by its place on the scale, the pass
+    line with and without rounding, the record it keeps, and each judgement it
+    refuses as one of another rubric.
+  - **`calibrationReport`**: agreement, kappa, correlation, error and mean
+    difference on pairs worked by hand; calibration error and the Brier score,
+    over bins several grades share; a second person's agreement and the
+    degradation from it; every metric that is undefined given as `null`; the
+    scores it will not read; and each reason it measures nothing.
+  - **`graderConfiguration`**, and the rubric hash a stored report is matched
+    on.
+  - **`routeGrade`**: every reason in its order; an exam failing closed without
+    a matching report, or with one of another prompt, rubric or target; each
+    threshold at its line, past it, and missing the metric it needs; and each
+    policy it refuses.
+  - **`inAuditSample`**, which pins who is audited, and
+    **`outcomeFromRoutedGrade`**.
 
 ## What it does not cover
 
@@ -155,6 +174,10 @@ a known hazard carry a `note` saying why they exist.
   for `missing`; a function cannot be stored as data, so only the built-in
   policies are pinned.
 - **xAPI statements**, and **anything `@intellectif/lk-react` renders**.
+- **What a model is told, and what is accepted from it** (`aiGradingRequest`,
+  `checkAiGrading` and the other AI checks). They decide whether there is a
+  grade, not what it is, and their own tests cover them. What a checked
+  judgement grades, `gradeFromJudgement`, is covered, above.
 - **Your own arithmetic.** If you round, aggregate or canonicalise answers
   yourself, this corpus says nothing about that code.
 - **Text of developer-facing diagnostics.** A vector can mark a field such as an