@lessonkit/lxpack 1.0.2 → 1.1.0

package/dist/bridge.cjs

@@ -155,10 +155,31 @@ function dispatchBridgeActionInner(bridge, action) {
       return;
   }
 }
+function forwardAssessmentCompletedToBridge(bridge, event) {
+  const data = event.data;
+  const scaled = normalizeAssessmentScore({
+    score: data.score,
+    maxScore: data.maxScore
+  });
+  if (scaled === null) return;
+  bridge.submitAssessment?.({
+    id: data.checkId,
+    score: scaled,
+    passingScore: normalizeAssessmentPassingScore({
+      passingScore: data.passingScore,
+      maxScore: data.maxScore
+    }),
+    maxScore: data.maxScore
+  });
+}
 function forwardTelemetryToBridge(event, mode = "auto", parentWindow) {
   if (mode === "off") return;
   const bridge = getBridge(parentWindow);
   if (!bridge) return;
+  if (event.name === "assessment_completed") {
+    forwardAssessmentCompletedToBridge(bridge, event);
+    return;
+  }
   const lessonkitEvent = telemetryEventToLessonkit(event);
   if (!lessonkitEvent) return;
   const action = (0, import_tracking_schema3.mapLessonkitTelemetryToBridgeAction)(lessonkitEvent);

package/dist/bridge.d.cts

@@ -24,7 +24,6 @@ declare function normalizeAssessmentPassingScore(opts?: {
 type LxpackBridgeMode = "auto" | "off";
 /** Apply a mapped bridge action to an LXPack bridge instance. */
 declare function dispatchBridgeAction(bridge: LxpackBridgeV1, action: ReturnType<typeof mapLessonkitTelemetryToBridgeAction>): void;
-/** Resolve bridge and dispatch a telemetry-derived action. */
 declare function forwardTelemetryToBridge(event: TelemetryEvent, mode?: LxpackBridgeMode, parentWindow?: Window): void;
 declare function createLxpackBridge(): LxpackBridgeV1 | null;
 declare function notifyLxpackLessonComplete(lessonId: LessonId): boolean;

package/dist/bridge.d.ts

@@ -24,7 +24,6 @@ declare function normalizeAssessmentPassingScore(opts?: {
 type LxpackBridgeMode = "auto" | "off";
 /** Apply a mapped bridge action to an LXPack bridge instance. */
 declare function dispatchBridgeAction(bridge: LxpackBridgeV1, action: ReturnType<typeof mapLessonkitTelemetryToBridgeAction>): void;
-/** Resolve bridge and dispatch a telemetry-derived action. */
 declare function forwardTelemetryToBridge(event: TelemetryEvent, mode?: LxpackBridgeMode, parentWindow?: Window): void;
 declare function createLxpackBridge(): LxpackBridgeV1 | null;
 declare function notifyLxpackLessonComplete(lessonId: LessonId): boolean;

package/dist/bridge.js

@@ -93,10 +93,31 @@ function dispatchBridgeActionInner(bridge, action) {
       return;
   }
 }
+function forwardAssessmentCompletedToBridge(bridge, event) {
+  const data = event.data;
+  const scaled = normalizeAssessmentScore({
+    score: data.score,
+    maxScore: data.maxScore
+  });
+  if (scaled === null) return;
+  bridge.submitAssessment?.({
+    id: data.checkId,
+    score: scaled,
+    passingScore: normalizeAssessmentPassingScore({
+      passingScore: data.passingScore,
+      maxScore: data.maxScore
+    }),
+    maxScore: data.maxScore
+  });
+}
 function forwardTelemetryToBridge(event, mode = "auto", parentWindow) {
   if (mode === "off") return;
   const bridge = getBridge(parentWindow);
   if (!bridge) return;
+  if (event.name === "assessment_completed") {
+    forwardAssessmentCompletedToBridge(bridge, event);
+    return;
+  }
   const lessonkitEvent = telemetryEventToLessonkit(event);
   if (!lessonkitEvent) return;
   const action = mapLessonkitTelemetryToBridgeAction2(lessonkitEvent);

package/dist/index.cjs

@@ -87,7 +87,8 @@ function assertResolvedPathUnderRoot(root, target) {
   const targetResolved = resolveComparablePath(target);
   const prefix = rootResolved.endsWith(import_node_path.sep) ? rootResolved : rootResolved + import_node_path.sep;
   const win32Prefix = rootResolved.endsWith(import_node_path.win32.sep) ? rootResolved : rootResolved + import_node_path.win32.sep;
-  if (targetResolved !== rootResolved && !targetResolved.startsWith(prefix) && !targetResolved.startsWith(win32Prefix)) {
+  if (targetResolved !== rootResolved && !targetResolved.startsWith(prefix) && /* v8 ignore next */
+  !targetResolved.startsWith(win32Prefix)) {
     throw new Error(`unsafe path escapes project root: ${target}`);
   }
 }
@@ -168,13 +169,36 @@ function parseAssessmentDescriptor(raw) {
   if (!isRecord(raw)) {
     return { checkId: "", question: "", choices: [], answer: "" };
   }
-  return {
+  const base = {
     checkId: typeof raw.checkId === "string" ? raw.checkId : "",
     question: typeof raw.question === "string" ? raw.question : "",
-    choices: Array.isArray(raw.choices) ? raw.choices.filter((c) => typeof c === "string") : [],
-    answer: typeof raw.answer === "string" ? raw.answer : "",
     passingScore: typeof raw.passingScore === "number" ? raw.passingScore : void 0
   };
+  const kind = raw.kind;
+  if (kind === "trueFalse") {
+    return {
+      kind: "trueFalse",
+      ...base,
+      answer: typeof raw.answer === "boolean" ? raw.answer : raw.answer === "true"
+    };
+  }
+  if (kind === "fillInBlanks") {
+    return {
+      kind: "fillInBlanks",
+      ...base,
+      template: typeof raw.template === "string" ? raw.template : "",
+      blanks: Array.isArray(raw.blanks) ? raw.blanks.filter((b) => isRecord(b)).map((b) => ({
+        id: typeof b.id === "string" ? b.id : "",
+        answer: typeof b.answer === "string" ? b.answer : ""
+      })) : void 0
+    };
+  }
+  return {
+    kind: kind === "mcq" ? "mcq" : void 0,
+    ...base,
+    choices: Array.isArray(raw.choices) ? raw.choices.filter((c) => typeof c === "string") : [],
+    answer: typeof raw.answer === "string" ? raw.answer : ""
+  };
 }
 function parseCourseDescriptorInput(input) {
   if (!isRecord(input)) return null;
@@ -237,10 +261,26 @@ function normalizeDescriptor(input) {
     assessments: input.assessments?.map((assessment) => {
       const check = (0, import_core.validateId)(assessment.checkId, "checkId");
       if (!check.ok) throw new Error("normalizeDescriptor called with invalid checkId");
+      const question = assessment.question.trim();
+      if (assessment.kind === "trueFalse") {
+        return { ...assessment, checkId: check.id, question };
+      }
+      if (assessment.kind === "fillInBlanks") {
+        return {
+          ...assessment,
+          checkId: check.id,
+          question,
+          template: assessment.template.trim(),
+          blanks: assessment.blanks?.map((b) => ({
+            id: b.id.trim(),
+            answer: b.answer.trim()
+          }))
+        };
+      }
       return {
         ...assessment,
         checkId: check.id,
-        question: assessment.question.trim(),
+        question,
         choices: assessment.choices.map((c) => c.trim()).filter((c) => c.length > 0),
         answer: assessment.answer.trim()
       };
@@ -383,17 +423,28 @@ function validateDescriptorParsed(input) {
     if (!assessment.question?.trim()) {
       issues.push({ path: `${path}.question`, message: "question is required" });
     }
-    const trimmedChoices = (assessment.choices ?? []).map((c) => c.trim()).filter((c) => c.length > 0);
-    if (!trimmedChoices.length) {
-      issues.push({
-        path: `${path}.choices`,
-        message: "at least one non-empty choice is required"
-      });
-    }
-    if (!assessment.answer?.trim()) {
-      issues.push({ path: `${path}.answer`, message: "answer is required" });
-    } else if (trimmedChoices.length && !trimmedChoices.includes(assessment.answer.trim())) {
-      issues.push({ path: `${path}.answer`, message: "answer must match a choice" });
+    const kind = assessment.kind ?? "mcq";
+    if (kind === "trueFalse" && assessment.kind === "trueFalse") {
+      if (typeof assessment.answer !== "boolean") {
+        issues.push({ path: `${path}.answer`, message: "answer must be a boolean for trueFalse" });
+      }
+    } else if (kind === "fillInBlanks" && assessment.kind === "fillInBlanks") {
+      if (!assessment.template?.trim()) {
+        issues.push({ path: `${path}.template`, message: "template is required for fillInBlanks" });
+      }
+    } else if ("choices" in assessment && "answer" in assessment && typeof assessment.answer === "string") {
+      const trimmedChoices = assessment.choices.map((c) => c.trim()).filter((c) => c.length > 0);
+      if (!trimmedChoices.length) {
+        issues.push({
+          path: `${path}.choices`,
+          message: "at least one non-empty choice is required"
+        });
+      }
+      if (!assessment.answer.trim()) {
+        issues.push({ path: `${path}.answer`, message: "answer is required" });
+      } else if (trimmedChoices.length && !trimmedChoices.includes(assessment.answer.trim())) {
+        issues.push({ path: `${path}.answer`, message: "answer must match a choice" });
+      }
     }
     const passingScore = assessment.passingScore;
     if (passingScore !== void 0 && !(Number.isFinite(passingScore) && passingScore > 0)) {
@@ -476,7 +527,7 @@ function slugChoiceId(text, index) {
   const stem = base.length ? base : "choice";
   return `${stem}-${index + 1}`;
 }
-function assessmentDescriptorToLxpack(assessment) {
+function mcqToLxpack(assessment) {
   const choices = assessment.choices.map((text, index) => {
     const id = slugChoiceId(text, index);
     return {
@@ -497,8 +548,30 @@ function assessmentDescriptorToLxpack(assessment) {
     ]
   };
 }
+function assessmentDescriptorToLxpack(assessment) {
+  const kind = assessment.kind ?? "mcq";
+  if (kind === "trueFalse" && assessment.kind === "trueFalse") {
+    const choices = ["True", "False"];
+    const answerText = assessment.answer ? "True" : "False";
+    return mcqToLxpack({
+      kind: "mcq",
+      checkId: assessment.checkId,
+      question: assessment.question,
+      choices,
+      answer: answerText,
+      passingScore: assessment.passingScore
+    });
+  }
+  if (kind === "fillInBlanks") {
+    return null;
+  }
+  if ("choices" in assessment && "answer" in assessment && typeof assessment.answer === "string") {
+    return mcqToLxpack(assessment);
+  }
+  return null;
+}
 function extractAssessments(descriptor) {
-  return (descriptor.assessments ?? []).map(assessmentDescriptorToLxpack);
+  return (descriptor.assessments ?? []).map(assessmentDescriptorToLxpack).filter((a) => a !== null);
 }
 
 // src/interchange.ts
@@ -571,7 +644,8 @@ async function resolveSpaDirs(options) {
   const { descriptor, spaDistDir, lessonSpaDirs, projectRoot } = options;
   const spaLessons = resolveSpaLessons(descriptor);
   if (descriptor.layout === "single-spa") {
-    const spaDistRelative = spaDistDir ?? descriptor.spaDistDir ?? "dist";
+    const spaDistRelative = spaDistDir ?? descriptor.spaDistDir ?? /* v8 ignore next */
+    "dist";
     const srcDist = projectRoot ? (0, import_node_path3.resolve)(projectRoot, spaDistRelative) : (0, import_node_path3.resolve)(spaDistRelative);
     if (projectRoot) {
       assertRealPathUnderRoot((0, import_node_path3.resolve)(projectRoot), srcDist);
@@ -586,7 +660,8 @@ async function resolveSpaDirs(options) {
     } catch {
       throw new Error(`spaDistDir must contain index.html: ${(0, import_node_path3.join)(srcDist, "index.html")}`);
     }
-    const lessonId = spaLessons[0]?.id ?? "main";
+    const lessonId = spaLessons[0]?.id ?? /* v8 ignore next */
+    "main";
     return { [lessonId]: srcDist };
   }
   const dirs = {};
@@ -670,7 +745,15 @@ function validatePackageInputs(options) {
         ok: false,
         courseDir: outDir,
         target,
-        issues: [{ path: "outDir", message: err instanceof Error ? err.message : String(err) }]
+        issues: [
+          {
+            path: "outDir",
+            message: (
+              /* v8 ignore next */
+              err instanceof Error ? err.message : String(err)
+            )
+          }
+        ]
       };
     }
   }
@@ -702,7 +785,10 @@ function validatePackageInputs(options) {
         issues: [
           {
             path: "outputBaseDir",
-            message: err instanceof Error ? err.message : String(err)
+            message: (
+              /* v8 ignore next */
+              err instanceof Error ? err.message : String(err)
+            )
           }
         ]
       };
@@ -717,7 +803,15 @@ function validatePackageInputs(options) {
         ok: false,
         courseDir: outDir,
         target,
-        issues: [{ path: "output", message: err instanceof Error ? err.message : String(err) }]
+        issues: [
+          {
+            path: "output",
+            message: (
+              /* v8 ignore next */
+              err instanceof Error ? err.message : String(err)
+            )
+          }
+        ]
       };
     }
   }
@@ -806,7 +900,10 @@ async function promoteStagingToOutDir(stagingDir, outDir) {
         try {
           await renameOrCopy(tmpPromote, failedPromote2);
         } catch {
-          await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(() => void 0);
+          await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(
+            /* v8 ignore next */
+            () => void 0
+          );
         }
         const promoteMsg = promoteError instanceof Error ? promoteError.message : String(promoteError);
         const restoreMsg = restoreError instanceof Error ? restoreError.message : String(restoreError);
@@ -822,7 +919,10 @@ async function promoteStagingToOutDir(stagingDir, outDir) {
           `[lessonkit/lxpack] failed to restore ${stagingDir} after promote error:`,
           restoreError instanceof Error ? restoreError.message : restoreError
         );
-        await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(() => void 0);
+        await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(
+          /* v8 ignore next */
+          () => void 0
+        );
       }
       throw promoteError;
     }
@@ -830,12 +930,18 @@ async function promoteStagingToOutDir(stagingDir, outDir) {
     try {
       await renameOrCopy(tmpPromote, failedPromote);
     } catch {
-      await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(() => void 0);
+      await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(
+        /* v8 ignore next */
+        () => void 0
+      );
     }
     throw promoteError;
   }
   if (backup) {
-    await fsp.rm(backup, { recursive: true, force: true }).catch(() => void 0);
+    await fsp.rm(backup, { recursive: true, force: true }).catch(
+      /* v8 ignore next */
+      () => void 0
+    );
   }
 }
 
@@ -898,7 +1004,10 @@ async function buildStagingPackage(options) {
       outputDir: "outputDir" in build ? build.outputDir : void 0
     };
   } catch (err) {
-    await fsp2.rm(stagingDir, { recursive: true, force: true }).catch(() => void 0);
+    await fsp2.rm(stagingDir, { recursive: true, force: true }).catch(
+      /* v8 ignore next */
+      () => void 0
+    );
     throw err;
   }
 }
@@ -964,7 +1073,10 @@ async function packageLessonkitCourse(options) {
     outputBaseDir
   });
   if (!staged.ok) {
-    await fsp3.rm(staged.stagingDir, { recursive: true, force: true }).catch(() => void 0);
+    await fsp3.rm(staged.stagingDir, { recursive: true, force: true }).catch(
+      /* v8 ignore next */
+      () => void 0
+    );
     const validation2 = staged.build ? { ok: false, issues: staged.build.issues } : void 0;
     return {
       ok: false,
@@ -982,7 +1094,10 @@ async function packageLessonkitCourse(options) {
     validateArtifactInStaging(stagingRoot, staged.outputDir, "outputDir")
   ].filter((issue) => issue != null);
   if (artifactIssues.length > 0) {
-    await fsp3.rm(stagingDir, { recursive: true, force: true }).catch(() => void 0);
+    await fsp3.rm(stagingDir, { recursive: true, force: true }).catch(
+      /* v8 ignore next */
+      () => void 0
+    );
     return {
       ok: false,
       courseDir: outDir,
@@ -1084,7 +1199,10 @@ function parseLessonkitManifest(raw, label = "lessonkit.json", projectRoot) {
   if (!validation.ok) {
     for (const i of validation.issues) {
       issues.push({
-        path: i.path.startsWith("course.") ? i.path : `course.${i.path}`,
+        path: (
+          /* v8 ignore next */
+          i.path.startsWith("course.") ? i.path : `course.${i.path}`
+        ),
         message: i.message
       });
     }

package/dist/index.d.cts

@@ -14,13 +14,34 @@ type LessonDescriptor = {
     /** Built SPA folder relative to the LXPack project root (`per-lesson-spa` only). */
     spaPath?: string;
 };
-type AssessmentDescriptor = {
+type McqAssessmentDescriptor = {
+    kind?: "mcq";
     checkId: CheckId;
     question: string;
     choices: string[];
     answer: string;
     passingScore?: number;
 };
+type TrueFalseAssessmentDescriptor = {
+    kind: "trueFalse";
+    checkId: CheckId;
+    question: string;
+    answer: boolean;
+    passingScore?: number;
+};
+type FillInBlanksAssessmentDescriptor = {
+    kind: "fillInBlanks";
+    checkId: CheckId;
+    question: string;
+    template: string;
+    blanks?: Array<{
+        id: string;
+        answer: string;
+    }>;
+    passingScore?: number;
+};
+/** Discriminated assessment entries in lessonkit.json (defaults to MCQ when kind omitted). */
+type AssessmentDescriptor = McqAssessmentDescriptor | TrueFalseAssessmentDescriptor | FillInBlanksAssessmentDescriptor;
 type LessonkitCourseDescriptor = {
     courseId: CourseId;
     title: string;
@@ -120,7 +141,7 @@ type LxpackInjectedAssessment = {
         }>;
     }>;
 };
-declare function assessmentDescriptorToLxpack(assessment: AssessmentDescriptor): LxpackInjectedAssessment;
+declare function assessmentDescriptorToLxpack(assessment: AssessmentDescriptor): LxpackInjectedAssessment | null;
 declare function extractAssessments(descriptor: LessonkitCourseDescriptor): LxpackInjectedAssessment[];
 
 type WriteLxpackProjectOptions = {
@@ -149,10 +170,6 @@ type WriteLxpackProjectResult = {
  */
 declare function writeLxpackProject(options: WriteLxpackProjectOptions): Promise<WriteLxpackProjectResult>;
 
-/**
- * Atomically replace `outDir` with the packaged tree at `stagingDir`.
- * Restores the previous `outDir` when promote fails after a backup rename.
- */
 declare function promoteStagingToOutDir(stagingDir: string, outDir: string): Promise<void>;
 
 type BuildStagingPackageOptions = WriteLxpackProjectOptions & {
@@ -273,4 +290,4 @@ type ParseManifestResult = {
 declare function parseLessonkitManifest(raw: unknown, label?: string, projectRoot?: string): ParseManifestResult;
 declare function loadLessonkitManifestFromFile(readJson: () => Promise<unknown>, label?: string, projectRoot?: string): Promise<ParseManifestResult>;
 
-export { type AssessmentDescriptor, type BuildLessonkitProjectOptions, type BuildStagingPackageOptions, type BuildStagingPackageResult, type DescriptorValidationIssue, type DescriptorValidationResult, type LessonDescriptor, type LessonkitCourseDescriptor, type LessonkitManifest, type LessonkitManifestPaths, type LxpackInjectedAssessment, type LxpackRuntimeTheme, type ManifestParseIssue, type MappedLessonkitIds, type PackageLessonkitCourseOptions, type PackageLessonkitCourseResult, type PackageValidationIssue, type ParseManifestResult, type ProjectPathsInput, type SpaLayout, type SpaLessonEntry, type ValidateLessonkitProjectOptions, type ValidatePackageInputsResult, type ValidationIssue, type WriteLxpackProjectOptions, type WriteLxpackProjectResult, assessmentDescriptorToLxpack, buildLessonkitProject, buildStagingPackage, descriptorToInterchange, ensureOutDirParent, extractAssessments, loadLessonkitManifestFromFile, mapLessonkitIds, packageLessonkitCourse, parseLessonkitManifest, promoteStagingToOutDir, remapArtifactPaths, resolveSafePackageOutputOverride, resolveSpaLessons, themeToLxpackRuntime, validateDescriptor, validateDescriptorForTarget, validateLessonkitProject, validatePackageInputs, validateProjectPaths, writeLxpackProject };
+export { type AssessmentDescriptor, type BuildLessonkitProjectOptions, type BuildStagingPackageOptions, type BuildStagingPackageResult, type DescriptorValidationIssue, type DescriptorValidationResult, type FillInBlanksAssessmentDescriptor, type LessonDescriptor, type LessonkitCourseDescriptor, type LessonkitManifest, type LessonkitManifestPaths, type LxpackInjectedAssessment, type LxpackRuntimeTheme, type ManifestParseIssue, type MappedLessonkitIds, type McqAssessmentDescriptor, type PackageLessonkitCourseOptions, type PackageLessonkitCourseResult, type PackageValidationIssue, type ParseManifestResult, type ProjectPathsInput, type SpaLayout, type SpaLessonEntry, type TrueFalseAssessmentDescriptor, type ValidateLessonkitProjectOptions, type ValidatePackageInputsResult, type ValidationIssue, type WriteLxpackProjectOptions, type WriteLxpackProjectResult, assessmentDescriptorToLxpack, buildLessonkitProject, buildStagingPackage, descriptorToInterchange, ensureOutDirParent, extractAssessments, loadLessonkitManifestFromFile, mapLessonkitIds, packageLessonkitCourse, parseLessonkitManifest, promoteStagingToOutDir, remapArtifactPaths, resolveSafePackageOutputOverride, resolveSpaLessons, themeToLxpackRuntime, validateDescriptor, validateDescriptorForTarget, validateLessonkitProject, validatePackageInputs, validateProjectPaths, writeLxpackProject };

package/dist/index.d.ts

@@ -14,13 +14,34 @@ type LessonDescriptor = {
     /** Built SPA folder relative to the LXPack project root (`per-lesson-spa` only). */
     spaPath?: string;
 };
-type AssessmentDescriptor = {
+type McqAssessmentDescriptor = {
+    kind?: "mcq";
     checkId: CheckId;
     question: string;
     choices: string[];
     answer: string;
     passingScore?: number;
 };
+type TrueFalseAssessmentDescriptor = {
+    kind: "trueFalse";
+    checkId: CheckId;
+    question: string;
+    answer: boolean;
+    passingScore?: number;
+};
+type FillInBlanksAssessmentDescriptor = {
+    kind: "fillInBlanks";
+    checkId: CheckId;
+    question: string;
+    template: string;
+    blanks?: Array<{
+        id: string;
+        answer: string;
+    }>;
+    passingScore?: number;
+};
+/** Discriminated assessment entries in lessonkit.json (defaults to MCQ when kind omitted). */
+type AssessmentDescriptor = McqAssessmentDescriptor | TrueFalseAssessmentDescriptor | FillInBlanksAssessmentDescriptor;
 type LessonkitCourseDescriptor = {
     courseId: CourseId;
     title: string;
@@ -120,7 +141,7 @@ type LxpackInjectedAssessment = {
         }>;
     }>;
 };
-declare function assessmentDescriptorToLxpack(assessment: AssessmentDescriptor): LxpackInjectedAssessment;
+declare function assessmentDescriptorToLxpack(assessment: AssessmentDescriptor): LxpackInjectedAssessment | null;
 declare function extractAssessments(descriptor: LessonkitCourseDescriptor): LxpackInjectedAssessment[];
 
 type WriteLxpackProjectOptions = {
@@ -149,10 +170,6 @@ type WriteLxpackProjectResult = {
  */
 declare function writeLxpackProject(options: WriteLxpackProjectOptions): Promise<WriteLxpackProjectResult>;
 
-/**
- * Atomically replace `outDir` with the packaged tree at `stagingDir`.
- * Restores the previous `outDir` when promote fails after a backup rename.
- */
 declare function promoteStagingToOutDir(stagingDir: string, outDir: string): Promise<void>;
 
 type BuildStagingPackageOptions = WriteLxpackProjectOptions & {
@@ -273,4 +290,4 @@ type ParseManifestResult = {
 declare function parseLessonkitManifest(raw: unknown, label?: string, projectRoot?: string): ParseManifestResult;
 declare function loadLessonkitManifestFromFile(readJson: () => Promise<unknown>, label?: string, projectRoot?: string): Promise<ParseManifestResult>;
 
-export { type AssessmentDescriptor, type BuildLessonkitProjectOptions, type BuildStagingPackageOptions, type BuildStagingPackageResult, type DescriptorValidationIssue, type DescriptorValidationResult, type LessonDescriptor, type LessonkitCourseDescriptor, type LessonkitManifest, type LessonkitManifestPaths, type LxpackInjectedAssessment, type LxpackRuntimeTheme, type ManifestParseIssue, type MappedLessonkitIds, type PackageLessonkitCourseOptions, type PackageLessonkitCourseResult, type PackageValidationIssue, type ParseManifestResult, type ProjectPathsInput, type SpaLayout, type SpaLessonEntry, type ValidateLessonkitProjectOptions, type ValidatePackageInputsResult, type ValidationIssue, type WriteLxpackProjectOptions, type WriteLxpackProjectResult, assessmentDescriptorToLxpack, buildLessonkitProject, buildStagingPackage, descriptorToInterchange, ensureOutDirParent, extractAssessments, loadLessonkitManifestFromFile, mapLessonkitIds, packageLessonkitCourse, parseLessonkitManifest, promoteStagingToOutDir, remapArtifactPaths, resolveSafePackageOutputOverride, resolveSpaLessons, themeToLxpackRuntime, validateDescriptor, validateDescriptorForTarget, validateLessonkitProject, validatePackageInputs, validateProjectPaths, writeLxpackProject };
+export { type AssessmentDescriptor, type BuildLessonkitProjectOptions, type BuildStagingPackageOptions, type BuildStagingPackageResult, type DescriptorValidationIssue, type DescriptorValidationResult, type FillInBlanksAssessmentDescriptor, type LessonDescriptor, type LessonkitCourseDescriptor, type LessonkitManifest, type LessonkitManifestPaths, type LxpackInjectedAssessment, type LxpackRuntimeTheme, type ManifestParseIssue, type MappedLessonkitIds, type McqAssessmentDescriptor, type PackageLessonkitCourseOptions, type PackageLessonkitCourseResult, type PackageValidationIssue, type ParseManifestResult, type ProjectPathsInput, type SpaLayout, type SpaLessonEntry, type TrueFalseAssessmentDescriptor, type ValidateLessonkitProjectOptions, type ValidatePackageInputsResult, type ValidationIssue, type WriteLxpackProjectOptions, type WriteLxpackProjectResult, assessmentDescriptorToLxpack, buildLessonkitProject, buildStagingPackage, descriptorToInterchange, ensureOutDirParent, extractAssessments, loadLessonkitManifestFromFile, mapLessonkitIds, packageLessonkitCourse, parseLessonkitManifest, promoteStagingToOutDir, remapArtifactPaths, resolveSafePackageOutputOverride, resolveSpaLessons, themeToLxpackRuntime, validateDescriptor, validateDescriptorForTarget, validateLessonkitProject, validatePackageInputs, validateProjectPaths, writeLxpackProject };

package/dist/index.js

@@ -28,7 +28,8 @@ function assertResolvedPathUnderRoot(root, target) {
   const targetResolved = resolveComparablePath(target);
   const prefix = rootResolved.endsWith(sep) ? rootResolved : rootResolved + sep;
   const win32Prefix = rootResolved.endsWith(win32.sep) ? rootResolved : rootResolved + win32.sep;
-  if (targetResolved !== rootResolved && !targetResolved.startsWith(prefix) && !targetResolved.startsWith(win32Prefix)) {
+  if (targetResolved !== rootResolved && !targetResolved.startsWith(prefix) && /* v8 ignore next */
+  !targetResolved.startsWith(win32Prefix)) {
     throw new Error(`unsafe path escapes project root: ${target}`);
   }
 }
@@ -109,13 +110,36 @@ function parseAssessmentDescriptor(raw) {
   if (!isRecord(raw)) {
     return { checkId: "", question: "", choices: [], answer: "" };
   }
-  return {
+  const base = {
     checkId: typeof raw.checkId === "string" ? raw.checkId : "",
     question: typeof raw.question === "string" ? raw.question : "",
-    choices: Array.isArray(raw.choices) ? raw.choices.filter((c) => typeof c === "string") : [],
-    answer: typeof raw.answer === "string" ? raw.answer : "",
     passingScore: typeof raw.passingScore === "number" ? raw.passingScore : void 0
   };
+  const kind = raw.kind;
+  if (kind === "trueFalse") {
+    return {
+      kind: "trueFalse",
+      ...base,
+      answer: typeof raw.answer === "boolean" ? raw.answer : raw.answer === "true"
+    };
+  }
+  if (kind === "fillInBlanks") {
+    return {
+      kind: "fillInBlanks",
+      ...base,
+      template: typeof raw.template === "string" ? raw.template : "",
+      blanks: Array.isArray(raw.blanks) ? raw.blanks.filter((b) => isRecord(b)).map((b) => ({
+        id: typeof b.id === "string" ? b.id : "",
+        answer: typeof b.answer === "string" ? b.answer : ""
+      })) : void 0
+    };
+  }
+  return {
+    kind: kind === "mcq" ? "mcq" : void 0,
+    ...base,
+    choices: Array.isArray(raw.choices) ? raw.choices.filter((c) => typeof c === "string") : [],
+    answer: typeof raw.answer === "string" ? raw.answer : ""
+  };
 }
 function parseCourseDescriptorInput(input) {
   if (!isRecord(input)) return null;
@@ -178,10 +202,26 @@ function normalizeDescriptor(input) {
     assessments: input.assessments?.map((assessment) => {
       const check = validateId(assessment.checkId, "checkId");
       if (!check.ok) throw new Error("normalizeDescriptor called with invalid checkId");
+      const question = assessment.question.trim();
+      if (assessment.kind === "trueFalse") {
+        return { ...assessment, checkId: check.id, question };
+      }
+      if (assessment.kind === "fillInBlanks") {
+        return {
+          ...assessment,
+          checkId: check.id,
+          question,
+          template: assessment.template.trim(),
+          blanks: assessment.blanks?.map((b) => ({
+            id: b.id.trim(),
+            answer: b.answer.trim()
+          }))
+        };
+      }
       return {
         ...assessment,
         checkId: check.id,
-        question: assessment.question.trim(),
+        question,
         choices: assessment.choices.map((c) => c.trim()).filter((c) => c.length > 0),
         answer: assessment.answer.trim()
       };
@@ -324,17 +364,28 @@ function validateDescriptorParsed(input) {
     if (!assessment.question?.trim()) {
       issues.push({ path: `${path}.question`, message: "question is required" });
     }
-    const trimmedChoices = (assessment.choices ?? []).map((c) => c.trim()).filter((c) => c.length > 0);
-    if (!trimmedChoices.length) {
-      issues.push({
-        path: `${path}.choices`,
-        message: "at least one non-empty choice is required"
-      });
-    }
-    if (!assessment.answer?.trim()) {
-      issues.push({ path: `${path}.answer`, message: "answer is required" });
-    } else if (trimmedChoices.length && !trimmedChoices.includes(assessment.answer.trim())) {
-      issues.push({ path: `${path}.answer`, message: "answer must match a choice" });
+    const kind = assessment.kind ?? "mcq";
+    if (kind === "trueFalse" && assessment.kind === "trueFalse") {
+      if (typeof assessment.answer !== "boolean") {
+        issues.push({ path: `${path}.answer`, message: "answer must be a boolean for trueFalse" });
+      }
+    } else if (kind === "fillInBlanks" && assessment.kind === "fillInBlanks") {
+      if (!assessment.template?.trim()) {
+        issues.push({ path: `${path}.template`, message: "template is required for fillInBlanks" });
+      }
+    } else if ("choices" in assessment && "answer" in assessment && typeof assessment.answer === "string") {
+      const trimmedChoices = assessment.choices.map((c) => c.trim()).filter((c) => c.length > 0);
+      if (!trimmedChoices.length) {
+        issues.push({
+          path: `${path}.choices`,
+          message: "at least one non-empty choice is required"
+        });
+      }
+      if (!assessment.answer.trim()) {
+        issues.push({ path: `${path}.answer`, message: "answer is required" });
+      } else if (trimmedChoices.length && !trimmedChoices.includes(assessment.answer.trim())) {
+        issues.push({ path: `${path}.answer`, message: "answer must match a choice" });
+      }
     }
     const passingScore = assessment.passingScore;
     if (passingScore !== void 0 && !(Number.isFinite(passingScore) && passingScore > 0)) {
@@ -417,7 +468,7 @@ function slugChoiceId(text, index) {
   const stem = base.length ? base : "choice";
   return `${stem}-${index + 1}`;
 }
-function assessmentDescriptorToLxpack(assessment) {
+function mcqToLxpack(assessment) {
   const choices = assessment.choices.map((text, index) => {
     const id = slugChoiceId(text, index);
     return {
@@ -438,8 +489,30 @@ function assessmentDescriptorToLxpack(assessment) {
     ]
   };
 }
+function assessmentDescriptorToLxpack(assessment) {
+  const kind = assessment.kind ?? "mcq";
+  if (kind === "trueFalse" && assessment.kind === "trueFalse") {
+    const choices = ["True", "False"];
+    const answerText = assessment.answer ? "True" : "False";
+    return mcqToLxpack({
+      kind: "mcq",
+      checkId: assessment.checkId,
+      question: assessment.question,
+      choices,
+      answer: answerText,
+      passingScore: assessment.passingScore
+    });
+  }
+  if (kind === "fillInBlanks") {
+    return null;
+  }
+  if ("choices" in assessment && "answer" in assessment && typeof assessment.answer === "string") {
+    return mcqToLxpack(assessment);
+  }
+  return null;
+}
 function extractAssessments(descriptor) {
-  return (descriptor.assessments ?? []).map(assessmentDescriptorToLxpack);
+  return (descriptor.assessments ?? []).map(assessmentDescriptorToLxpack).filter((a) => a !== null);
 }
 
 // src/interchange.ts
@@ -512,7 +585,8 @@ async function resolveSpaDirs(options) {
   const { descriptor, spaDistDir, lessonSpaDirs, projectRoot } = options;
   const spaLessons = resolveSpaLessons(descriptor);
   if (descriptor.layout === "single-spa") {
-    const spaDistRelative = spaDistDir ?? descriptor.spaDistDir ?? "dist";
+    const spaDistRelative = spaDistDir ?? descriptor.spaDistDir ?? /* v8 ignore next */
+    "dist";
     const srcDist = projectRoot ? resolve3(projectRoot, spaDistRelative) : resolve3(spaDistRelative);
     if (projectRoot) {
       assertRealPathUnderRoot(resolve3(projectRoot), srcDist);
@@ -527,7 +601,8 @@ async function resolveSpaDirs(options) {
     } catch {
       throw new Error(`spaDistDir must contain index.html: ${join(srcDist, "index.html")}`);
     }
-    const lessonId = spaLessons[0]?.id ?? "main";
+    const lessonId = spaLessons[0]?.id ?? /* v8 ignore next */
+    "main";
     return { [lessonId]: srcDist };
   }
   const dirs = {};
@@ -614,7 +689,15 @@ function validatePackageInputs(options) {
         ok: false,
         courseDir: outDir,
         target,
-        issues: [{ path: "outDir", message: err instanceof Error ? err.message : String(err) }]
+        issues: [
+          {
+            path: "outDir",
+            message: (
+              /* v8 ignore next */
+              err instanceof Error ? err.message : String(err)
+            )
+          }
+        ]
       };
     }
   }
@@ -646,7 +729,10 @@ function validatePackageInputs(options) {
         issues: [
           {
             path: "outputBaseDir",
-            message: err instanceof Error ? err.message : String(err)
+            message: (
+              /* v8 ignore next */
+              err instanceof Error ? err.message : String(err)
+            )
           }
         ]
       };
@@ -661,7 +747,15 @@ function validatePackageInputs(options) {
         ok: false,
         courseDir: outDir,
         target,
-        issues: [{ path: "output", message: err instanceof Error ? err.message : String(err) }]
+        issues: [
+          {
+            path: "output",
+            message: (
+              /* v8 ignore next */
+              err instanceof Error ? err.message : String(err)
+            )
+          }
+        ]
       };
     }
   }
@@ -750,7 +844,10 @@ async function promoteStagingToOutDir(stagingDir, outDir) {
         try {
           await renameOrCopy(tmpPromote, failedPromote2);
         } catch {
-          await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(() => void 0);
+          await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(
+            /* v8 ignore next */
+            () => void 0
+          );
         }
         const promoteMsg = promoteError instanceof Error ? promoteError.message : String(promoteError);
         const restoreMsg = restoreError instanceof Error ? restoreError.message : String(restoreError);
@@ -766,7 +863,10 @@ async function promoteStagingToOutDir(stagingDir, outDir) {
           `[lessonkit/lxpack] failed to restore ${stagingDir} after promote error:`,
           restoreError instanceof Error ? restoreError.message : restoreError
         );
-        await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(() => void 0);
+        await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(
+          /* v8 ignore next */
+          () => void 0
+        );
       }
       throw promoteError;
     }
@@ -774,12 +874,18 @@ async function promoteStagingToOutDir(stagingDir, outDir) {
     try {
       await renameOrCopy(tmpPromote, failedPromote);
     } catch {
-      await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(() => void 0);
+      await fsp.rm(tmpPromote, { recursive: true, force: true }).catch(
+        /* v8 ignore next */
+        () => void 0
+      );
     }
     throw promoteError;
   }
   if (backup) {
-    await fsp.rm(backup, { recursive: true, force: true }).catch(() => void 0);
+    await fsp.rm(backup, { recursive: true, force: true }).catch(
+      /* v8 ignore next */
+      () => void 0
+    );
   }
 }
 
@@ -842,7 +948,10 @@ async function buildStagingPackage(options) {
       outputDir: "outputDir" in build ? build.outputDir : void 0
     };
   } catch (err) {
-    await fsp2.rm(stagingDir, { recursive: true, force: true }).catch(() => void 0);
+    await fsp2.rm(stagingDir, { recursive: true, force: true }).catch(
+      /* v8 ignore next */
+      () => void 0
+    );
     throw err;
   }
 }
@@ -908,7 +1017,10 @@ async function packageLessonkitCourse(options) {
     outputBaseDir
   });
   if (!staged.ok) {
-    await fsp3.rm(staged.stagingDir, { recursive: true, force: true }).catch(() => void 0);
+    await fsp3.rm(staged.stagingDir, { recursive: true, force: true }).catch(
+      /* v8 ignore next */
+      () => void 0
+    );
     const validation2 = staged.build ? { ok: false, issues: staged.build.issues } : void 0;
     return {
       ok: false,
@@ -926,7 +1038,10 @@ async function packageLessonkitCourse(options) {
     validateArtifactInStaging(stagingRoot, staged.outputDir, "outputDir")
   ].filter((issue) => issue != null);
   if (artifactIssues.length > 0) {
-    await fsp3.rm(stagingDir, { recursive: true, force: true }).catch(() => void 0);
+    await fsp3.rm(stagingDir, { recursive: true, force: true }).catch(
+      /* v8 ignore next */
+      () => void 0
+    );
     return {
       ok: false,
       courseDir: outDir,
@@ -1028,7 +1143,10 @@ function parseLessonkitManifest(raw, label = "lessonkit.json", projectRoot) {
   if (!validation.ok) {
     for (const i of validation.issues) {
       issues.push({
-        path: i.path.startsWith("course.") ? i.path : `course.${i.path}`,
+        path: (
+          /* v8 ignore next */
+          i.path.startsWith("course.") ? i.path : `course.${i.path}`
+        ),
         message: i.message
       });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessonkit/lxpack",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "private": false,
   "description": "LXPack export adapter for LessonKit courses (SCORM, standalone, xAPI, cmi5).",
   "license": "Apache-2.0",
@@ -55,8 +55,8 @@
     "lint": "echo \"(no lint configured yet)\""
   },
   "dependencies": {
-    "@lessonkit/core": "1.0.2",
-    "@lessonkit/themes": "1.0.2",
+    "@lessonkit/core": "1.1.0",
+    "@lessonkit/themes": "1.1.0",
     "@lxpack/api": "^0.6.2",
     "@lxpack/spa-bridge": "^0.6.2",
     "@lxpack/tracking-schema": "^0.6.2",