@intellectif/lk-core 0.2.1 → 0.3.1

package/dist/chunk-YNTYWHZI.cjs

@@ -0,0 +1,57 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkQOAORTA4cjs = require('./chunk-QOAORTA4.cjs');
+
+
+var _chunkPIMX4B4Dcjs = require('./chunk-PIMX4B4D.cjs');
+
+// src/schemas/json-schema.ts
+var _v4 = require('zod/v4');
+var multipleChoiceJsonSchema = _v4.z.toJSONSchema(_chunkQOAORTA4cjs.MultipleChoiceDataSchema, {
+  target: "draft-7"
+});
+var fillInTheBlanksJsonSchema = _v4.z.toJSONSchema(_chunkQOAORTA4cjs.FillInTheBlanksDataSchema, {
+  target: "draft-7"
+});
+var writtenResponseJsonSchema = _v4.z.toJSONSchema(_chunkQOAORTA4cjs.WrittenResponseDataSchema, {
+  target: "draft-7"
+});
+function jsonSchemaFor(type) {
+  const descriptor = _chunkQOAORTA4cjs.getActivityTypeDescriptor.call(void 0, type);
+  if (descriptor === void 0) {
+    throw new (0, _chunkPIMX4B4Dcjs.UnknownActivityTypeError)(type);
+  }
+  return _v4.z.toJSONSchema(descriptor.schema, { target: "draft-7" });
+}
+
+// src/schemas/index.ts
+function validateActivity(type, data) {
+  const descriptor = _chunkQOAORTA4cjs.getActivityTypeDescriptor.call(void 0, type);
+  if (descriptor === void 0) {
+    throw new (0, _chunkPIMX4B4Dcjs.UnknownActivityTypeError)(String(type));
+  }
+  const result = descriptor.schema.safeParse(data);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  return {
+    success: false,
+    errors: result.error.issues.map((issue) => ({
+      path: issue.path.map(String),
+      message: issue.message,
+      code: issue.code
+    }))
+  };
+}
+
+
+
+
+
+
+
+exports.multipleChoiceJsonSchema = multipleChoiceJsonSchema; exports.fillInTheBlanksJsonSchema = fillInTheBlanksJsonSchema; exports.writtenResponseJsonSchema = writtenResponseJsonSchema; exports.jsonSchemaFor = jsonSchemaFor; exports.validateActivity = validateActivity;
+//# sourceMappingURL=chunk-YNTYWHZI.cjs.map

package/dist/chunk-YNTYWHZI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/chunk-YNTYWHZI.cjs","../src/schemas/json-schema.ts","../src/schemas/index.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACVA,4BAAkB;AAiBX,IAAM,yBAAA,EAA2B,KAAA,CAAE,YAAA,CAAa,0CAAA,EAA0B;AAAA,EAC/E,MAAA,EAAQ;AACV,CAAC,CAAA;AAOM,IAAM,0BAAA,EAA4B,KAAA,CAAE,YAAA,CAAa,2CAAA,EAA2B;AAAA,EACjF,MAAA,EAAQ;AACV,CAAC,CAAA;AAMM,IAAM,0BAAA,EAA4B,KAAA,CAAE,YAAA,CAAa,2CAAA,EAA2B;AAAA,EACjF,MAAA,EAAQ;AACV,CAAC,CAAA;AAUM,SAAS,aAAA,CAAc,IAAA,EAAuC;AACnE,EAAA,MAAM,WAAA,EAAa,yDAAA,IAA8B,CAAA;AACjD,EAAA,GAAA,CAAI,WAAA,IAAe,KAAA,CAAA,EAAW;AAC5B,IAAA,MAAM,IAAI,+CAAA,CAAyB,IAAI,CAAA;AAAA,EACzC;AACA,EAAA,OAAO,KAAA,CAAE,YAAA,CAAa,UAAA,CAAW,MAAA,EAAiB,EAAE,MAAA,EAAQ,UAAU,CAAC,CAAA;AAIzE;AD3BA;AACA;AEcO,SAAS,gBAAA,CACd,IAAA,EACA,IAAA,EACsC;AACtC,EAAA,MAAM,WAAA,EAAa,yDAAA,IAA8B,CAAA;AACjD,EAAA,GAAA,CAAI,WAAA,IAAe,KAAA,CAAA,EAAW;AAC5B,IAAA,MAAM,IAAI,+CAAA,CAAyB,MAAA,CAAO,IAAI,CAAC,CAAA;AAAA,EACjD;AAEA,EAAA,MAAM,OAAA,EAAS,UAAA,CAAW,MAAA,CAAO,SAAA,CAAU,IAAI,CAAA;AAE/C,EAAA,GAAA,CAAI,MAAA,CAAO,OAAA,EAAS;AAClB,IAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,IAAA,EAAM,MAAA,CAAO,KAA2B,CAAA;AAAA,EAClE;AAEA,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,KAAA;AAAA,IACT,MAAA,EAAQ,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,EAAA,GAAA,CAAW;AAAA,MAC1C,IAAA,EAAM,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA;AAAA,MAC3B,OAAA,EAAS,KAAA,CAAM,OAAA;AAAA,MACf,IAAA,EAAM,KAAA,CAAM;AAAA,IACd,CAAA,CAAE;AAAA,EACJ,CAAA;AACF;AFlBA;AACA;AACE;AACA;AACA;AACA;AACA;AACF,8QAAC","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/chunk-YNTYWHZI.cjs","sourcesContent":[null,"import { z } from 'zod/v4';\nimport { UnknownActivityTypeError } from '../errors.js';\nimport { getActivityTypeDescriptor } from '../registry/index.js';\nimport { FillInTheBlanksDataSchema } from './fill-in-the-blanks.js';\nimport { MultipleChoiceDataSchema } from './multiple-choice.js';\nimport { WrittenResponseDataSchema } from './written-response.js';\n\n/**\n * JSON Schema (Draft 7) representation of the Multiple Choice activity data\n * contract, generated natively by Zod 4. Draft 7 is mandated by Requirement\n * 2.2 for the widest AI-prompt / OpenAPI tooling compatibility. The semantic\n * `.refine()` guards are not representable in JSON Schema and are\n * intentionally omitted — the export captures the *structural* contract only.\n * Since v0.3 the source schemas are loose, so these no longer emit\n * `additionalProperties: false` — the JSON Schema and `validateActivity` now\n * agree on unknown-key handling.\n */\nexport const multipleChoiceJsonSchema = z.toJSONSchema(MultipleChoiceDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * JSON Schema (Draft 7) representation of the Fill-in-the-Blanks activity data\n * contract, generated natively by Zod 4. Structural contract only (semantic\n * `.refine()` guards are Zod-only and not representable in JSON Schema).\n */\nexport const fillInTheBlanksJsonSchema = z.toJSONSchema(FillInTheBlanksDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * JSON Schema (Draft 7) representation of the Written Response activity data\n * contract. Structural contract only.\n */\nexport const writtenResponseJsonSchema = z.toJSONSchema(WrittenResponseDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * Derives the JSON Schema (Draft 7) for any REGISTERED activity type — the\n * live, registry-backed replacement for the static per-type exports above,\n * and the building block for AI generation pipelines (R6.1): pass the result\n * as a structured-output schema so a model can only emit valid items.\n *\n * @throws UnknownActivityTypeError when `type` has no registered descriptor.\n */\nexport function jsonSchemaFor(type: string): Record<string, unknown> {\n  const descriptor = getActivityTypeDescriptor(type);\n  if (descriptor === undefined) {\n    throw new UnknownActivityTypeError(type);\n  }\n  return z.toJSONSchema(descriptor.schema as never, { target: 'draft-7' }) as Record<\n    string,\n    unknown\n  >;\n}\n","import { UnknownActivityTypeError } from '../errors.js';\nimport { getActivityTypeDescriptor } from '../registry/index.js';\nimport type { ActivityDataMap, ActivityType, ValidationResult } from '../types/activity.js';\n\nexport { FeedbackSchema } from './feedback.js';\nexport {\n  BlankConfigSchema,\n  FillInTheBlanksDataSchema,\n  TextMatchPolicySchema,\n} from './fill-in-the-blanks.js';\nexport {\n  fillInTheBlanksJsonSchema,\n  jsonSchemaFor,\n  multipleChoiceJsonSchema,\n  writtenResponseJsonSchema,\n} from './json-schema.js';\nexport { MediaSchema, MediaUrlSchema } from './media.js';\nexport { MultipleChoiceDataSchema, MultipleChoiceOptionSchema } from './multiple-choice.js';\nexport {\n  RedactedBlankConfigSchema,\n  RedactedFillInTheBlanksDataSchema,\n  RedactedMultipleChoiceDataSchema,\n  RedactedMultipleChoiceOptionSchema,\n  RedactedWrittenResponseDataSchema,\n} from './redacted.js';\nexport {\n  WrittenResponseDataSchema,\n  WrittenResponseRubricCriterionSchema,\n  WrittenResponseRubricSchema,\n} from './written-response.js';\n\n/**\n * Validates raw activity data against the schema registered for the given\n * activity type (built-in or consumer-registered via `registerActivityType`).\n *\n * Unknown keys are PRESERVED, not stripped: every built-in schema is loose,\n * so consumer sidecar fields and forward-version fields survive validation\n * verbatim in the returned `data`.\n *\n * @returns `{ success: true, data }` with the typed, validated data, or\n *          `{ success: false, errors }` with one entry per failed constraint.\n * @throws UnknownActivityTypeError when `type` has no registered descriptor.\n */\nexport function validateActivity<T extends ActivityType>(\n  type: T,\n  data: unknown,\n): ValidationResult<ActivityDataMap[T]> {\n  const descriptor = getActivityTypeDescriptor(type);\n  if (descriptor === undefined) {\n    throw new UnknownActivityTypeError(String(type));\n  }\n\n  const result = descriptor.schema.safeParse(data);\n\n  if (result.success) {\n    return { success: true, data: result.data as ActivityDataMap[T] };\n  }\n\n  return {\n    success: false,\n    errors: result.error.issues.map((issue) => ({\n      path: issue.path.map(String),\n      message: issue.message,\n      code: issue.code,\n    })),\n  };\n}\n"]}

package/dist/index.cjs

@@ -1,28 +1,27 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
 
 
-var _chunk3JMLUUFScjs = require('./chunk-3JMLUUFS.cjs');
 
 
+var _chunkTHSZMZNDcjs = require('./chunk-THSZMZND.cjs');
 
 
 
-var _chunkPJFDAP54cjs = require('./chunk-PJFDAP54.cjs');
 
 
+var _chunkRUGIOQZYcjs = require('./chunk-RUGIOQZY.cjs');
 
-var _chunkDV466SBJcjs = require('./chunk-DV466SBJ.cjs');
 
 
 
 
 
+var _chunkYNTYWHZIcjs = require('./chunk-YNTYWHZI.cjs');
 
 
 
 
 
-var _chunkDCDOTQNHcjs = require('./chunk-DCDOTQNH.cjs');
 
 
 
@@ -41,5 +40,185 @@ var _chunkDCDOTQNHcjs = require('./chunk-DCDOTQNH.cjs');
 
 
 
-exports.ActivitySchemaError = _chunkDV466SBJcjs.ActivitySchemaError; exports.BlankConfigSchema = _chunkDCDOTQNHcjs.BlankConfigSchema; exports.FeedbackSchema = _chunkDCDOTQNHcjs.FeedbackSchema; exports.FillInTheBlanksDataSchema = _chunkDCDOTQNHcjs.FillInTheBlanksDataSchema; exports.MediaSchema = _chunkDCDOTQNHcjs.MediaSchema; exports.MultipleChoiceDataSchema = _chunkDCDOTQNHcjs.MultipleChoiceDataSchema; exports.MultipleChoiceOptionSchema = _chunkDCDOTQNHcjs.MultipleChoiceOptionSchema; exports.UnknownActivityTypeError = _chunkDV466SBJcjs.UnknownActivityTypeError; exports.XAPIVerb = _chunkPJFDAP54cjs.XAPIVerb; exports.XAPI_VERB_DISPLAY = _chunkPJFDAP54cjs.XAPI_VERB_DISPLAY; exports.computePassThreshold = _chunk3JMLUUFScjs.computePassThreshold; exports.fillInTheBlanksJsonSchema = _chunkDCDOTQNHcjs.fillInTheBlanksJsonSchema; exports.multipleChoiceJsonSchema = _chunkDCDOTQNHcjs.multipleChoiceJsonSchema; exports.score = _chunk3JMLUUFScjs.score; exports.validateActivity = _chunkDCDOTQNHcjs.validateActivity; exports.validateXAPIStatement = _chunkPJFDAP54cjs.validateXAPIStatement; exports.xAPIBuilder = _chunkPJFDAP54cjs.xAPIBuilder;
+
+
+
+
+var _chunkQOAORTA4cjs = require('./chunk-QOAORTA4.cjs');
+
+
+
+
+
+var _chunkPIMX4B4Dcjs = require('./chunk-PIMX4B4D.cjs');
+
+// src/redact.ts
+function mergePolicy(base, overrides) {
+  if (overrides === void 0) {
+    return base;
+  }
+  const merged = { ...base };
+  for (const [key, override] of Object.entries(overrides)) {
+    const current = merged[key];
+    merged[key] = typeof override === "object" && typeof current === "object" ? { ...current, ...override } : override;
+  }
+  return merged;
+}
+function isSensitivity(value) {
+  return typeof value === "string";
+}
+function keepField(sensitivity, reveal) {
+  if (sensitivity === "public") {
+    return true;
+  }
+  return sensitivity === "answer-key" && reveal === "after-submit";
+}
+function redactValue(value, policy, reveal) {
+  if (Array.isArray(value)) {
+    return value.map((element) => redactValue(element, policy, reveal));
+  }
+  if (value === null || typeof value !== "object") {
+    return void 0;
+  }
+  const source = value;
+  const output = {};
+  for (const [key, fieldValue] of Object.entries(source)) {
+    if (fieldValue === void 0) {
+      continue;
+    }
+    const classification = policy[key];
+    if (classification === void 0) {
+      continue;
+    }
+    if (isSensitivity(classification)) {
+      if (keepField(classification, reveal)) {
+        output[key] = fieldValue;
+      }
+      continue;
+    }
+    const nested = redactValue(fieldValue, classification, reveal);
+    if (nested !== void 0) {
+      output[key] = nested;
+    }
+  }
+  return output;
+}
+function redact(data, options = {}) {
+  const reveal = _nullishCoalesce(options.reveal, () => ( "none"));
+  const descriptor = _chunkQOAORTA4cjs.getActivityTypeDescriptor.call(void 0, data.type);
+  if (descriptor === void 0) {
+    throw new (0, _chunkPIMX4B4Dcjs.UnknownActivityTypeError)(String(data.type));
+  }
+  if (descriptor.fieldPolicy === void 0) {
+    throw new Error(
+      `Activity type "${descriptor.type}" has no fieldPolicy; redact() cannot run fail-closed redaction without one.`
+    );
+  }
+  const effectivePolicy = mergePolicy(descriptor.fieldPolicy, options.policy);
+  const projected = redactValue(data, effectivePolicy, reveal);
+  const result = { ...projected, redacted: true };
+  if (reveal === "none" && descriptor.redactedSchema !== void 0) {
+    const parsed = descriptor.redactedSchema.safeParse(result);
+    if (!parsed.success) {
+      throw new (0, _chunkPIMX4B4Dcjs.ActivitySchemaError)(
+        descriptor.type,
+        parsed.error.issues.map((issue) => ({
+          path: issue.path.map(String),
+          message: issue.message,
+          code: issue.code
+        }))
+      );
+    }
+  }
+  return result;
+}
+function assertRedacted(data) {
+  if (typeof data !== "object" || data === null) {
+    throw new (0, _chunkPIMX4B4Dcjs.ActivitySchemaError)("unknown", [
+      { path: [], message: "Redacted activity data must be an object.", code: "invalid_type" }
+    ]);
+  }
+  const candidate = data;
+  if (candidate.redacted !== true) {
+    throw new (0, _chunkPIMX4B4Dcjs.ActivitySchemaError)(String(_nullishCoalesce(candidate.type, () => ( "unknown"))), [
+      {
+        path: ["redacted"],
+        message: "Missing redacted marker \u2014 this payload is not a redact() projection.",
+        code: "custom"
+      }
+    ]);
+  }
+  const type = typeof candidate.type === "string" ? candidate.type : "";
+  const descriptor = _chunkQOAORTA4cjs.getActivityTypeDescriptor.call(void 0, type);
+  if (descriptor === void 0) {
+    throw new (0, _chunkPIMX4B4Dcjs.UnknownActivityTypeError)(type);
+  }
+  if (descriptor.redactedSchema === void 0) {
+    throw new (0, _chunkPIMX4B4Dcjs.ActivitySchemaError)(descriptor.type, [
+      {
+        path: [],
+        message: `Activity type "${descriptor.type}" registers no redactedSchema; assertRedacted cannot prove this payload is learner-safe.`,
+        code: "custom"
+      }
+    ]);
+  }
+  const parsed = descriptor.redactedSchema.safeParse(candidate);
+  if (!parsed.success) {
+    throw new (0, _chunkPIMX4B4Dcjs.ActivitySchemaError)(
+      descriptor.type,
+      parsed.error.issues.map((issue) => ({
+        path: issue.path.map(String),
+        message: issue.message,
+        code: issue.code
+      }))
+    );
+  }
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.ActivitySchemaError = _chunkPIMX4B4Dcjs.ActivitySchemaError; exports.BlankConfigSchema = _chunkQOAORTA4cjs.BlankConfigSchema; exports.DEFAULT_PASS_THRESHOLD = _chunkTHSZMZNDcjs.DEFAULT_PASS_THRESHOLD; exports.DeferredScoringError = _chunkPIMX4B4Dcjs.DeferredScoringError; exports.FeedbackSchema = _chunkQOAORTA4cjs.FeedbackSchema; exports.FillInTheBlanksDataSchema = _chunkQOAORTA4cjs.FillInTheBlanksDataSchema; exports.MediaSchema = _chunkQOAORTA4cjs.MediaSchema; exports.MediaUrlSchema = _chunkQOAORTA4cjs.MediaUrlSchema; exports.MultipleChoiceDataSchema = _chunkQOAORTA4cjs.MultipleChoiceDataSchema; exports.MultipleChoiceOptionSchema = _chunkQOAORTA4cjs.MultipleChoiceOptionSchema; exports.RedactedBlankConfigSchema = _chunkQOAORTA4cjs.RedactedBlankConfigSchema; exports.RedactedFillInTheBlanksDataSchema = _chunkQOAORTA4cjs.RedactedFillInTheBlanksDataSchema; exports.RedactedMultipleChoiceDataSchema = _chunkQOAORTA4cjs.RedactedMultipleChoiceDataSchema; exports.RedactedMultipleChoiceOptionSchema = _chunkQOAORTA4cjs.RedactedMultipleChoiceOptionSchema; exports.RedactedScoringError = _chunkPIMX4B4Dcjs.RedactedScoringError; exports.RedactedWrittenResponseDataSchema = _chunkQOAORTA4cjs.RedactedWrittenResponseDataSchema; exports.TextMatchPolicySchema = _chunkQOAORTA4cjs.TextMatchPolicySchema; exports.UnknownActivityTypeError = _chunkPIMX4B4Dcjs.UnknownActivityTypeError; exports.WrittenResponseDataSchema = _chunkQOAORTA4cjs.WrittenResponseDataSchema; exports.WrittenResponseRubricCriterionSchema = _chunkQOAORTA4cjs.WrittenResponseRubricCriterionSchema; exports.WrittenResponseRubricSchema = _chunkQOAORTA4cjs.WrittenResponseRubricSchema; exports.XAPIVerb = _chunkRUGIOQZYcjs.XAPIVerb; exports.XAPI_VERB_DISPLAY = _chunkRUGIOQZYcjs.XAPI_VERB_DISPLAY; exports.assertRedacted = assertRedacted; exports.computePassThreshold = _chunkTHSZMZNDcjs.computePassThreshold; exports.countWords = _chunkQOAORTA4cjs.countWords; exports.defineActivityType = _chunkQOAORTA4cjs.defineActivityType; exports.evaluate = _chunkTHSZMZNDcjs.evaluate; exports.fillInTheBlanksJsonSchema = _chunkYNTYWHZIcjs.fillInTheBlanksJsonSchema; exports.fillInTheBlanksType = _chunkQOAORTA4cjs.fillInTheBlanksType; exports.getActivityTypeDescriptor = _chunkQOAORTA4cjs.getActivityTypeDescriptor; exports.jsonSchemaFor = _chunkYNTYWHZIcjs.jsonSchemaFor; exports.levenshteinDistance = _chunkQOAORTA4cjs.levenshteinDistance; exports.matchText = _chunkQOAORTA4cjs.matchText; exports.multipleChoiceJsonSchema = _chunkYNTYWHZIcjs.multipleChoiceJsonSchema; exports.multipleChoiceType = _chunkQOAORTA4cjs.multipleChoiceType; exports.redact = redact; exports.registerActivityType = _chunkQOAORTA4cjs.registerActivityType; exports.registeredActivityTypes = _chunkQOAORTA4cjs.registeredActivityTypes; exports.score = _chunkTHSZMZNDcjs.score; exports.validateActivity = _chunkYNTYWHZIcjs.validateActivity; exports.validateXAPIStatement = _chunkRUGIOQZYcjs.validateXAPIStatement; exports.writtenResponseJsonSchema = _chunkYNTYWHZIcjs.writtenResponseJsonSchema; exports.writtenResponseType = _chunkQOAORTA4cjs.writtenResponseType; exports.xAPIBuilder = _chunkRUGIOQZYcjs.xAPIBuilder;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,onCAAC","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/index.cjs"}
+{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/index.cjs","../src/redact.ts"],"names":[],"mappings":"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","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/index.cjs","sourcesContent":[null,"import { ActivitySchemaError, UnknownActivityTypeError } from './errors.js';\nimport { getActivityTypeDescriptor } from './registry/index.js';\nimport type { FieldPolicy, Sensitivity } from './registry/registry.js';\n\n/**\n * A learner-safe projection of activity data produced by {@link redact}:\n * the activity's public fields plus the `redacted: true` marker. Renderable\n * and validatable (each built-in type registers a strict redacted schema),\n * but stripped of the answer key, scoring rules, authored feedback, and\n * author-only assets.\n */\nexport interface RedactedActivityData {\n  redacted: true;\n  schemaVersion: string;\n  type: string;\n  id: string;\n  title: string;\n  [key: string]: unknown;\n}\n\n/** Options for {@link redact}. */\nexport interface RedactOptions {\n  /**\n   * Which sensitivity tiers to keep beyond `public`:\n   * - `'none'` (default) — public fields only; the output satisfies the\n   *   type's strict redacted schema and `assertRedacted`.\n   * - `'after-submit'` — public + answer-key fields (for post-submission\n   *   review renders). `author-only` fields and unclassified fields are\n   *   STILL removed; the output will NOT pass `assertRedacted`.\n   */\n  reveal?: 'none' | 'after-submit';\n  /**\n   * Per-call sensitivity overrides, merged over the type's registered\n   * `fieldPolicy` (top-level keys replace; nested objects merge one level).\n   *\n   * Sensitivity is partly a PEDAGOGICAL decision, not purely a security one —\n   * whether a rubric or a hint is learner-visible differs legitimately between\n   * deployments — and the SDK must not freeze that choice. Use this to tighten\n   * a field the SDK ships as `public`:\n   *\n   * ```ts\n   * redact(essay, { policy: { rubric: 'author-only' } });\n   * ```\n   *\n   * Overrides can only be applied to fields; they cannot re-open a field the\n   * caller has not classified, because unclassified still means removed.\n   * Note that tightening below what the type's `redactedSchema` requires is\n   * allowed — the schema check only rejects payloads that reveal MORE than\n   * the learner-safe shape.\n   */\n  policy?: FieldPolicy;\n}\n\n/** Merges per-call overrides over a registered policy, one level deep. */\nfunction mergePolicy(base: FieldPolicy, overrides: FieldPolicy | undefined): FieldPolicy {\n  if (overrides === undefined) {\n    return base;\n  }\n  const merged: Record<string, Sensitivity | FieldPolicy> = { ...base };\n  for (const [key, override] of Object.entries(overrides)) {\n    const current = merged[key];\n    merged[key] =\n      typeof override === 'object' && typeof current === 'object'\n        ? { ...current, ...override }\n        : override;\n  }\n  return merged;\n}\n\nfunction isSensitivity(value: Sensitivity | FieldPolicy): value is Sensitivity {\n  return typeof value === 'string';\n}\n\nfunction keepField(sensitivity: Sensitivity, reveal: 'none' | 'after-submit'): boolean {\n  if (sensitivity === 'public') {\n    return true;\n  }\n  return sensitivity === 'answer-key' && reveal === 'after-submit';\n}\n\nfunction redactValue(\n  value: unknown,\n  policy: FieldPolicy,\n  reveal: 'none' | 'after-submit',\n): unknown {\n  if (Array.isArray(value)) {\n    return value.map((element) => redactValue(element, policy, reveal));\n  }\n  if (value === null || typeof value !== 'object') {\n    // A nested FieldPolicy cannot classify a primitive's sub-fields; the\n    // policy author classified an object shape that is not there. Fail\n    // closed: drop it (handled by the caller returning undefined).\n    return undefined;\n  }\n\n  const source = value as Record<string, unknown>;\n  const output: Record<string, unknown> = {};\n  for (const [key, fieldValue] of Object.entries(source)) {\n    if (fieldValue === undefined) {\n      continue;\n    }\n    const classification = policy[key];\n    if (classification === undefined) {\n      // Fail closed: unclassified fields are never emitted, at any reveal\n      // level. Adding a field without classifying it hides it — never leaks it.\n      continue;\n    }\n    if (isSensitivity(classification)) {\n      if (keepField(classification, reveal)) {\n        output[key] = fieldValue;\n      }\n      continue;\n    }\n    const nested = redactValue(fieldValue, classification, reveal);\n    if (nested !== undefined) {\n      output[key] = nested;\n    }\n  }\n  return output;\n}\n\n/**\n * Produces the learner-safe projection of activity data (R7), driven by the\n * `fieldPolicy` registered for `data.type`. Fail-closed and exhaustive by\n * construction: a field the policy does not classify is removed — including\n * unknown passthrough fields — so a NEW field added by a future SDK or a\n * consumer sidecar can never leak through an out-of-date redactor.\n *\n * With the default `reveal: 'none'`, the output validates against the type's\n * strict redacted schema (verified here; an invalid projection throws\n * {@link ActivitySchemaError} rather than shipping an unproven payload).\n *\n * @throws UnknownActivityTypeError when `data.type` is not registered.\n * @throws Error when the registered descriptor declares no `fieldPolicy`\n *         (redaction cannot guess sensitivities).\n */\nexport function redact<T extends { type: string }>(\n  data: T,\n  options: RedactOptions = {},\n): RedactedActivityData {\n  const reveal = options.reveal ?? 'none';\n  const descriptor = getActivityTypeDescriptor(data.type);\n  if (descriptor === undefined) {\n    throw new UnknownActivityTypeError(String(data.type));\n  }\n  if (descriptor.fieldPolicy === undefined) {\n    throw new Error(\n      `Activity type \"${descriptor.type}\" has no fieldPolicy; redact() cannot run fail-closed redaction without one.`,\n    );\n  }\n\n  const effectivePolicy = mergePolicy(descriptor.fieldPolicy, options.policy);\n  const projected = redactValue(data, effectivePolicy, reveal) as Record<string, unknown>;\n  const result = { ...projected, redacted: true as const } as RedactedActivityData;\n\n  if (reveal === 'none' && descriptor.redactedSchema !== undefined) {\n    const parsed = descriptor.redactedSchema.safeParse(result);\n    if (!parsed.success) {\n      throw new ActivitySchemaError(\n        descriptor.type,\n        parsed.error.issues.map((issue) => ({\n          path: issue.path.map(String),\n          message: issue.message,\n          code: issue.code,\n        })),\n      );\n    }\n  }\n\n  return result;\n}\n\n/**\n * Asserts that `data` is a learner-safe redacted projection: it carries the\n * `redacted: true` marker and, when its type registers a strict redacted\n * schema, validates against it (proving the absence of answer-key fields).\n * Use this at the server boundary before sending activity data to a client\n * that must not hold the key.\n */\nexport function assertRedacted(data: unknown): asserts data is RedactedActivityData {\n  if (typeof data !== 'object' || data === null) {\n    throw new ActivitySchemaError('unknown', [\n      { path: [], message: 'Redacted activity data must be an object.', code: 'invalid_type' },\n    ]);\n  }\n  const candidate = data as Record<string, unknown>;\n  if (candidate.redacted !== true) {\n    throw new ActivitySchemaError(String(candidate.type ?? 'unknown'), [\n      {\n        path: ['redacted'],\n        message: 'Missing redacted marker — this payload is not a redact() projection.',\n        code: 'custom',\n      },\n    ]);\n  }\n  const type = typeof candidate.type === 'string' ? candidate.type : '';\n  const descriptor = getActivityTypeDescriptor(type);\n  if (descriptor === undefined) {\n    throw new UnknownActivityTypeError(type);\n  }\n  if (descriptor.redactedSchema === undefined) {\n    // Fail closed: without a registered redacted schema there is no way to\n    // PROVE the absence of answer-key fields, and a marker alone proves\n    // nothing (any object can carry `redacted: true`).\n    throw new ActivitySchemaError(descriptor.type, [\n      {\n        path: [],\n        message: `Activity type \"${descriptor.type}\" registers no redactedSchema; assertRedacted cannot prove this payload is learner-safe.`,\n        code: 'custom',\n      },\n    ]);\n  }\n  const parsed = descriptor.redactedSchema.safeParse(candidate);\n  if (!parsed.success) {\n    throw new ActivitySchemaError(\n      descriptor.type,\n      parsed.error.issues.map((issue) => ({\n        path: issue.path.map(String),\n        message: issue.message,\n        code: issue.code,\n      })),\n    );\n  }\n}\n"]}

package/dist/index.d.cts

@@ -1,9 +1,18 @@
-import { V as ValidationError } from './activity-D5tqgx8A.cjs';
-export { A as ActivityData, a as ActivityDataMap, b as ActivityFeedback, c as ActivityMedia, d as ActivityResult, e as ActivityType, B as BlankConfig, F as FillInTheBlanksData, f as FillInTheBlanksLearnerResponse, I as InteractionEvent, L as LearnerResponse, M as MultipleChoiceData, g as MultipleChoiceLearnerResponse, h as MultipleChoiceOption, S as ScoringDetail, i as ScoringResult, j as ValidationResult, X as XAPIActor, k as XAPIConfig, l as XAPIContext, m as XAPIError, n as XAPIObject, o as XAPIResult, p as XAPIScore, q as XAPIStatement, r as XAPIVerbObject } from './activity-D5tqgx8A.cjs';
-export { BlankConfigSchema, FeedbackSchema, FillInTheBlanksDataSchema, MediaSchema, MultipleChoiceDataSchema, MultipleChoiceOptionSchema, fillInTheBlanksJsonSchema, multipleChoiceJsonSchema, validateActivity } from './schemas.cjs';
-export { computePassThreshold, score } from './scoring.cjs';
-export { AnsweredStatementParams, CompletedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder } from './xapi.cjs';
-import 'zod/v4';
+import { V as ValidationError, m as ScoringResult, D as DeferredScoringPartial, F as FillInTheBlanksData, f as FillInTheBlanksLearnerResponse, M as MultipleChoiceData, j as MultipleChoiceLearnerResponse, W as WrittenResponseData, p as WrittenResponseLearnerResponse } from './activity-zdcAMtFB.cjs';
+export { A as ActivityData, a as ActivityDataMap, b as ActivityFeedback, c as ActivityMedia, d as ActivityResult, e as ActivityType, B as BlankConfig, I as InteractionEvent, g as InteractionKind, h as ItemOutcome, L as LearnerResponse, i as LearnerResponseMap, k as MultipleChoiceOption, S as ScoringDetail, l as ScoringOutcome, T as TextMatchPolicy, n as TextMatchResult, o as ValidationResult, q as WrittenResponseRubric, r as WrittenResponseRubricCriterion, X as XAPIActor, s as XAPIConfig, t as XAPIContext, u as XAPIContextActivities, v as XAPIError, w as XAPIObject, x as XAPIResult, y as XAPIScore, z as XAPIStatement, C as XAPIVerbObject, E as levenshteinDistance, G as matchText } from './activity-zdcAMtFB.cjs';
+import { z } from 'zod/v4';
+export { BlankConfigSchema, FeedbackSchema, FillInTheBlanksDataSchema, MediaSchema, MediaUrlSchema, MultipleChoiceDataSchema, MultipleChoiceOptionSchema, RedactedBlankConfigSchema, RedactedFillInTheBlanksDataSchema, RedactedMultipleChoiceDataSchema, RedactedMultipleChoiceOptionSchema, RedactedWrittenResponseDataSchema, TextMatchPolicySchema, WrittenResponseDataSchema, WrittenResponseRubricCriterionSchema, WrittenResponseRubricSchema, fillInTheBlanksJsonSchema, jsonSchemaFor, multipleChoiceJsonSchema, validateActivity, writtenResponseJsonSchema } from './schemas.cjs';
+export { DEFAULT_PASS_THRESHOLD, computePassThreshold, evaluate, score } from './scoring.cjs';
+export { AnsweredStatementParams, CompletedStatementParams, SubmittedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder } from './xapi.cjs';
+
+/**
+ * Canonical word counter for written-response bounds (Req 22.9): tokens are
+ * maximal runs of non-whitespace (split on `\s+`), so hyphenated forms
+ * (`well-known`) count as one word. The empty / whitespace-only string counts
+ * 0. Consumers must use this helper rather than re-implementing the split so
+ * client previews, SDK scoring, and stored `wordCount` values always agree.
+ */
+declare function countWords(text: string): number;
 
 /** Thrown when activity data fails schema validation at a component boundary. */
 declare class ActivitySchemaError extends Error {
@@ -16,6 +25,243 @@ declare class UnknownActivityTypeError extends Error {
     readonly activityType: string;
     constructor(activityType: string);
 }
+/**
+ * Thrown when `score()` is asked to grade a `redact()` projection (or any
+ * activity data whose answer key is missing, yielding a non-finite score).
+ * Redacted data is learner-safe precisely because the key was removed, so a
+ * score derived from it is meaningless — previously this produced a silent
+ * `NaN` that serialized to `null` in a grade column. `evaluate()` returns
+ * `{ status: 'unscorable' }` for the same input instead of throwing.
+ */
+declare class RedactedScoringError extends Error {
+    readonly activityType: string;
+    constructor(activityType: string);
+}
+/**
+ * Thrown when `score()` is called for an activity type whose grading is
+ * deferred (asynchronous AI/human grading, e.g. `written-response`). A
+ * deferred submission has no synchronous score — treating it as 0 would show
+ * a learner a failing grade for work that simply has not been graded yet.
+ * Call `evaluate()` instead, which returns `{ status: 'deferred', ... }`.
+ */
+declare class DeferredScoringError extends Error {
+    readonly activityType: string;
+    constructor(activityType: string);
+}
+
+/** ScoringResult without `passed` — the public `score()` / `evaluate()` fill that in. */
+type PartialScoringResult = Omit<ScoringResult, 'passed'>;
+/**
+ * Sensitivity classification of a single activity-data field, driving
+ * `redact()`:
+ * - `public` — safe to send to a learner before they answer.
+ * - `answer-key` — reveals (or helps infer) the correct answer or the scoring
+ *   rules; removed unless `reveal: 'after-submit'` is requested.
+ * - `author-only` — never leaves the authoring/grading context (e.g. rubrics).
+ */
+type Sensitivity = 'public' | 'answer-key' | 'author-only';
+/**
+ * Per-field sensitivity map for an activity type. A `Sensitivity` value
+ * classifies the whole field (objects and arrays included); a nested
+ * `FieldPolicy` recurses into an object field — and, for an array field,
+ * applies to every element. Fail-closed: any field a policy does not mention
+ * is treated as `author-only` and removed by `redact()` — adding a field
+ * without classifying it hides it, never leaks it.
+ */
+interface FieldPolicy {
+    readonly [field: string]: Sensitivity | FieldPolicy;
+}
+/** xAPI interaction types defined by xAPI 1.0.3 (cmi.interaction vocabulary). */
+type XAPIInteractionType = 'choice' | 'fill-in' | 'long-fill-in' | 'matching' | 'sequencing' | 'performance' | 'true-false' | 'other';
+/** Interop facts a generic statement builder cannot infer from data alone. */
+interface ActivityTypeInterop<TData> {
+    /** IRI for the xAPI Activity `definition.type`. */
+    readonly xapiActivityTypeIri?: string;
+    /** xAPI `definition.interactionType` for this activity type. */
+    readonly xapiInteractionType?: XAPIInteractionType;
+    /** Builds the xAPI `correctResponsesPattern` strings for an item. */
+    readonly correctResponsesPattern?: (data: TData) => string[];
+}
+/**
+ * How responses to an activity type are graded:
+ * - `sync` — a pure function produces the grade at submit time.
+ * - `deferred` — grading happens asynchronously (AI or human) after
+ *   submission; `partial` reports the facts computable synchronously
+ *   (e.g. word counts), surfaced in `ItemOutcome.partial`.
+ */
+type ActivityTypeScoring<TData, TResponse> = {
+    readonly kind: 'sync';
+    readonly score: (data: TData, response: TResponse) => PartialScoringResult;
+} | {
+    readonly kind: 'deferred';
+    readonly reason: 'requires_async_grading';
+    readonly partial?: (data: TData, response: TResponse | undefined) => DeferredScoringPartial;
+};
+/**
+ * A value-level description of an activity type: its contract (schema), its
+ * grading, its redaction policy, and its interop facts. Registering a
+ * descriptor makes `validateActivity`, `score`, `evaluate`, `redact`, and
+ * `jsonSchemaFor` work for the type — an activity type is a value, not a
+ * hardcoded union member (R1).
+ */
+interface ActivityTypeDescriptor<TData extends {
+    type: string;
+}, TResponse> {
+    /** The `type` discriminator string (kebab-case by convention). */
+    readonly type: TData['type'];
+    /** Zod schema validating the activity's data contract. */
+    readonly schema: z.ZodType<TData>;
+    /** How responses are graded. */
+    readonly scoring: ActivityTypeScoring<TData, TResponse>;
+    /** Whether a response counts as an answer (vs. blank/untouched). */
+    readonly isAnswered?: (response: TResponse | undefined) => boolean;
+    /** Per-field sensitivity map driving `redact()`. Fail-closed. */
+    readonly fieldPolicy?: FieldPolicy;
+    /**
+     * Schema the output of `redact(data)` (with default `reveal: 'none'`) must
+     * satisfy. Strict by design: it proves the ABSENCE of answer-key fields,
+     * so `assertRedacted` can guarantee a payload is safe to send to a learner.
+     */
+    readonly redactedSchema?: z.ZodType<unknown>;
+    /** Interop facts for xAPI (and later QTI) statement building. */
+    readonly interop?: ActivityTypeInterop<TData>;
+    /** The interaction-event kinds components for this type emit. */
+    readonly interactions?: readonly string[];
+}
+/**
+ * Internal type-erased descriptor shape stored in the registry. Dispatch call
+ * sites cast payloads back; the public generic API preserves inference.
+ */
+interface RegisteredActivityTypeDescriptor {
+    readonly type: string;
+    readonly schema: z.ZodType<unknown>;
+    readonly scoring: {
+        readonly kind: 'sync';
+        readonly score: (data: unknown, response: unknown) => PartialScoringResult;
+    } | {
+        readonly kind: 'deferred';
+        readonly reason: 'requires_async_grading';
+        readonly partial?: (data: unknown, response: unknown) => DeferredScoringPartial;
+    };
+    readonly isAnswered?: (response: unknown) => boolean;
+    readonly fieldPolicy?: FieldPolicy;
+    readonly redactedSchema?: z.ZodType<unknown>;
+    readonly interop?: ActivityTypeInterop<unknown>;
+    readonly interactions?: readonly string[];
+}
+/**
+ * Identity helper that gives full type inference when authoring a descriptor:
+ *
+ * ```ts
+ * const myType = defineActivityType<MyTypeData, MyTypeLearnerResponse>({ ... });
+ * registerActivityType(myType);
+ * ```
+ */
+declare function defineActivityType<TData extends {
+    type: string;
+}, TResponse>(descriptor: ActivityTypeDescriptor<TData, TResponse>): ActivityTypeDescriptor<TData, TResponse>;
+/**
+ * Registers an activity type on the default registry, making it live for
+ * `validateActivity`, `score`, `evaluate`, `redact`, and `jsonSchemaFor`.
+ * Re-registering the same descriptor object is a no-op; registering a
+ * DIFFERENT descriptor under an existing type throws — silently replacing a
+ * type's contract or scoring is exactly the class of accident a summative
+ * SDK must not allow.
+ */
+declare function registerActivityType<TData extends {
+    type: string;
+}, TResponse>(descriptor: ActivityTypeDescriptor<TData, TResponse>): void;
+/** Returns the registered descriptor for `type`, or `undefined`. */
+declare function getActivityTypeDescriptor(type: string): RegisteredActivityTypeDescriptor | undefined;
+/** The type strings currently registered (built-ins plus consumer-registered). */
+declare function registeredActivityTypes(): string[];
+
+/**
+ * A learner-safe projection of activity data produced by {@link redact}:
+ * the activity's public fields plus the `redacted: true` marker. Renderable
+ * and validatable (each built-in type registers a strict redacted schema),
+ * but stripped of the answer key, scoring rules, authored feedback, and
+ * author-only assets.
+ */
+interface RedactedActivityData {
+    redacted: true;
+    schemaVersion: string;
+    type: string;
+    id: string;
+    title: string;
+    [key: string]: unknown;
+}
+/** Options for {@link redact}. */
+interface RedactOptions {
+    /**
+     * Which sensitivity tiers to keep beyond `public`:
+     * - `'none'` (default) — public fields only; the output satisfies the
+     *   type's strict redacted schema and `assertRedacted`.
+     * - `'after-submit'` — public + answer-key fields (for post-submission
+     *   review renders). `author-only` fields and unclassified fields are
+     *   STILL removed; the output will NOT pass `assertRedacted`.
+     */
+    reveal?: 'none' | 'after-submit';
+    /**
+     * Per-call sensitivity overrides, merged over the type's registered
+     * `fieldPolicy` (top-level keys replace; nested objects merge one level).
+     *
+     * Sensitivity is partly a PEDAGOGICAL decision, not purely a security one —
+     * whether a rubric or a hint is learner-visible differs legitimately between
+     * deployments — and the SDK must not freeze that choice. Use this to tighten
+     * a field the SDK ships as `public`:
+     *
+     * ```ts
+     * redact(essay, { policy: { rubric: 'author-only' } });
+     * ```
+     *
+     * Overrides can only be applied to fields; they cannot re-open a field the
+     * caller has not classified, because unclassified still means removed.
+     * Note that tightening below what the type's `redactedSchema` requires is
+     * allowed — the schema check only rejects payloads that reveal MORE than
+     * the learner-safe shape.
+     */
+    policy?: FieldPolicy;
+}
+/**
+ * Produces the learner-safe projection of activity data (R7), driven by the
+ * `fieldPolicy` registered for `data.type`. Fail-closed and exhaustive by
+ * construction: a field the policy does not classify is removed — including
+ * unknown passthrough fields — so a NEW field added by a future SDK or a
+ * consumer sidecar can never leak through an out-of-date redactor.
+ *
+ * With the default `reveal: 'none'`, the output validates against the type's
+ * strict redacted schema (verified here; an invalid projection throws
+ * {@link ActivitySchemaError} rather than shipping an unproven payload).
+ *
+ * @throws UnknownActivityTypeError when `data.type` is not registered.
+ * @throws Error when the registered descriptor declares no `fieldPolicy`
+ *         (redaction cannot guess sensitivities).
+ */
+declare function redact<T extends {
+    type: string;
+}>(data: T, options?: RedactOptions): RedactedActivityData;
+/**
+ * Asserts that `data` is a learner-safe redacted projection: it carries the
+ * `redacted: true` marker and, when its type registers a strict redacted
+ * schema, validates against it (proving the absence of answer-key fields).
+ * Use this at the server boundary before sending activity data to a client
+ * that must not hold the key.
+ */
+declare function assertRedacted(data: unknown): asserts data is RedactedActivityData;
+
+/** Built-in Multiple Choice descriptor. */
+declare const multipleChoiceType: ActivityTypeDescriptor<MultipleChoiceData, MultipleChoiceLearnerResponse>;
+/** Built-in Fill-in-the-Blanks descriptor. */
+declare const fillInTheBlanksType: ActivityTypeDescriptor<FillInTheBlanksData, FillInTheBlanksLearnerResponse>;
+/**
+ * Built-in Written Response descriptor. Grading is DEFERRED: submissions are
+ * graded asynchronously (AI or human) by the consumer; the synchronous
+ * outcome reports only word-count facts. `wordCount` is recomputed from the
+ * submitted text with the canonical `countWords()` — the client-supplied
+ * count is informational, never trusted.
+ */
+declare const writtenResponseType: ActivityTypeDescriptor<WrittenResponseData, WrittenResponseLearnerResponse>;
 
 /**
  * All CSS custom property tokens consumed by learning-kit components.
@@ -53,4 +299,4 @@ interface ThemeTokens {
     '--lk-transition-base': string;
 }
 
-export { ActivitySchemaError, type ThemeTokens, UnknownActivityTypeError, ValidationError };
+export { ActivitySchemaError, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, DeferredScoringError, DeferredScoringPartial, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, MultipleChoiceData, MultipleChoiceLearnerResponse, type PartialScoringResult, type RedactOptions, type RedactedActivityData, RedactedScoringError, type RegisteredActivityTypeDescriptor, ScoringResult, type Sensitivity, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, assertRedacted, countWords, defineActivityType, fillInTheBlanksType, getActivityTypeDescriptor, multipleChoiceType, redact, registerActivityType, registeredActivityTypes, writtenResponseType };