@lessonkit/lxpack 1.0.2 → 1.2.0

package/dist/index.cjs

@@ -61,8 +61,187 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/validateDescriptor.ts
+// src/descriptor/normalize.ts
 var import_core = require("@lessonkit/core");
+function normalizeDescriptor(input) {
+  const course = (0, import_core.validateId)(input.courseId, "courseId");
+  if (!course.ok) throw new Error("normalizeDescriptor called with invalid courseId");
+  return {
+    ...input,
+    courseId: course.id,
+    title: input.title.trim(),
+    version: input.version?.trim() || void 0,
+    spaLessonId: input.spaLessonId?.trim() || void 0,
+    lessons: input.lessons.map((lesson) => {
+      const idResult = (0, import_core.validateId)(lesson.id, "lessonId");
+      if (!idResult.ok) throw new Error("normalizeDescriptor called with invalid lesson id");
+      return {
+        ...lesson,
+        id: idResult.id,
+        title: lesson.title.trim(),
+        spaPath: lesson.spaPath?.trim() || void 0
+      };
+    }),
+    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()
+          }))
+        };
+      }
+      if (assessment.kind === "findHotspot") {
+        return {
+          ...assessment,
+          checkId: check.id,
+          question,
+          src: assessment.src.trim(),
+          alt: assessment.alt.trim(),
+          correctTargetId: assessment.correctTargetId.trim()
+        };
+      }
+      if (assessment.kind === "findMultipleHotspots") {
+        return {
+          ...assessment,
+          checkId: check.id,
+          question,
+          src: assessment.src.trim(),
+          alt: assessment.alt.trim(),
+          correctTargetIds: assessment.correctTargetIds.map((id) => id.trim()).filter((id) => id.length > 0)
+        };
+      }
+      const mcq = assessment;
+      return {
+        ...mcq,
+        checkId: check.id,
+        question,
+        choices: mcq.choices.map((c) => c.trim()).filter((c) => c.length > 0),
+        answer: mcq.answer.trim()
+      };
+    })
+  };
+}
+
+// src/descriptor/parseInput.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseLessonDescriptor(raw) {
+  if (!isRecord(raw)) {
+    return { id: "", title: "" };
+  }
+  return {
+    id: typeof raw.id === "string" ? raw.id : "",
+    title: typeof raw.title === "string" ? raw.title : "",
+    spaPath: typeof raw.spaPath === "string" ? raw.spaPath : void 0
+  };
+}
+function parseAssessmentDescriptor(raw) {
+  if (!isRecord(raw)) {
+    return { checkId: "", question: "", choices: [], answer: "" };
+  }
+  const base = {
+    checkId: typeof raw.checkId === "string" ? raw.checkId : "",
+    question: typeof raw.question === "string" ? raw.question : "",
+    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
+    };
+  }
+  if (kind === "findHotspot") {
+    return {
+      kind: "findHotspot",
+      ...base,
+      src: typeof raw.src === "string" ? raw.src : "",
+      alt: typeof raw.alt === "string" ? raw.alt : "",
+      correctTargetId: typeof raw.correctTargetId === "string" ? raw.correctTargetId : ""
+    };
+  }
+  if (kind === "findMultipleHotspots") {
+    return {
+      kind: "findMultipleHotspots",
+      ...base,
+      src: typeof raw.src === "string" ? raw.src : "",
+      alt: typeof raw.alt === "string" ? raw.alt : "",
+      correctTargetIds: Array.isArray(raw.correctTargetIds) ? raw.correctTargetIds.filter((id) => typeof id === "string") : []
+    };
+  }
+  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;
+  const trackingRaw = input.tracking;
+  let tracking;
+  if (isRecord(trackingRaw)) {
+    const completionRaw = trackingRaw.completion;
+    const xapiRaw = trackingRaw.xapi;
+    tracking = {
+      completion: isRecord(completionRaw) ? {
+        threshold: typeof completionRaw.threshold === "number" ? completionRaw.threshold : void 0
+      } : void 0,
+      xapi: isRecord(xapiRaw) ? {
+        activityIri: typeof xapiRaw.activityIri === "string" ? xapiRaw.activityIri : void 0
+      } : void 0
+    };
+  }
+  const themeRaw = input.theme;
+  let theme;
+  if (isRecord(themeRaw)) {
+    theme = {
+      preset: typeof themeRaw.preset === "string" ? themeRaw.preset : void 0
+    };
+    if (isRecord(themeRaw.theme)) {
+      theme.theme = themeRaw.theme;
+    }
+  }
+  return {
+    courseId: typeof input.courseId === "string" ? input.courseId : "",
+    title: typeof input.title === "string" ? input.title : "",
+    version: typeof input.version === "string" ? input.version : void 0,
+    layout: typeof input.layout === "string" ? input.layout : void 0,
+    lessons: Array.isArray(input.lessons) ? input.lessons.map(parseLessonDescriptor) : [],
+    assessments: Array.isArray(input.assessments) ? input.assessments.map(parseAssessmentDescriptor) : void 0,
+    theme,
+    tracking,
+    spaDistDir: typeof input.spaDistDir === "string" ? input.spaDistDir : void 0,
+    spaLessonId: typeof input.spaLessonId === "string" ? input.spaLessonId : void 0
+  };
+}
+
+// src/descriptor/validateCourse.ts
+var import_core3 = require("@lessonkit/core");
 
 // src/spaPath.ts
 var import_node_fs = require("fs");
@@ -87,7 +266,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}`);
   }
 }
@@ -148,133 +328,69 @@ function themeToLxpackRuntime(input) {
   };
 }
 
-// src/validateDescriptor.ts
-var VALID_LAYOUTS = ["single-spa", "per-lesson-spa"];
-var VALID_THEME_PRESETS = ["default", "light", "dark", "brand"];
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function parseLessonDescriptor(raw) {
-  if (!isRecord(raw)) {
-    return { id: "", title: "" };
+// src/descriptor/validateAssessments.ts
+var import_core2 = require("@lessonkit/core");
+var validateMcqLike = (assessment, path, issues) => {
+  if (!("choices" in assessment) || !("answer" in assessment) || typeof assessment.answer !== "string") {
+    return;
   }
-  return {
-    id: typeof raw.id === "string" ? raw.id : "",
-    title: typeof raw.title === "string" ? raw.title : "",
-    spaPath: typeof raw.spaPath === "string" ? raw.spaPath : void 0
-  };
-}
-function parseAssessmentDescriptor(raw) {
-  if (!isRecord(raw)) {
-    return { checkId: "", question: "", choices: [], answer: "" };
+  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" });
   }
-  return {
-    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
-  };
-}
-function parseCourseDescriptorInput(input) {
-  if (!isRecord(input)) return null;
-  const trackingRaw = input.tracking;
-  let tracking;
-  if (isRecord(trackingRaw)) {
-    const completionRaw = trackingRaw.completion;
-    const xapiRaw = trackingRaw.xapi;
-    tracking = {
-      completion: isRecord(completionRaw) ? {
-        threshold: typeof completionRaw.threshold === "number" ? completionRaw.threshold : void 0
-      } : void 0,
-      xapi: isRecord(xapiRaw) ? {
-        activityIri: typeof xapiRaw.activityIri === "string" ? xapiRaw.activityIri : void 0
-      } : void 0
-    };
+  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 themeRaw = input.theme;
-  let theme;
-  if (isRecord(themeRaw)) {
-    theme = {
-      preset: typeof themeRaw.preset === "string" ? themeRaw.preset : void 0
-    };
-    if (isRecord(themeRaw.theme)) {
-      theme.theme = themeRaw.theme;
+};
+var ASSESSMENT_VALIDATORS = {
+  mcq: validateMcqLike,
+  trueFalse: (assessment, path, issues) => {
+    if (assessment.kind === "trueFalse" && typeof assessment.answer !== "boolean") {
+      issues.push({ path: `${path}.answer`, message: "answer must be a boolean for trueFalse" });
     }
+  },
+  fillInBlanks: (assessment, path, issues) => {
+    if (assessment.kind === "fillInBlanks" && !assessment.template?.trim()) {
+      issues.push({ path: `${path}.template`, message: "template is required for fillInBlanks" });
+    }
+  },
+  findHotspot: () => {
+  },
+  findMultipleHotspots: () => {
   }
-  return {
-    courseId: typeof input.courseId === "string" ? input.courseId : "",
-    title: typeof input.title === "string" ? input.title : "",
-    version: typeof input.version === "string" ? input.version : void 0,
-    layout: typeof input.layout === "string" ? input.layout : void 0,
-    lessons: Array.isArray(input.lessons) ? input.lessons.map(parseLessonDescriptor) : [],
-    assessments: Array.isArray(input.assessments) ? input.assessments.map(parseAssessmentDescriptor) : void 0,
-    theme,
-    tracking,
-    spaDistDir: typeof input.spaDistDir === "string" ? input.spaDistDir : void 0,
-    spaLessonId: typeof input.spaLessonId === "string" ? input.spaLessonId : void 0
-  };
-}
-function normalizeDescriptor(input) {
-  const course = (0, import_core.validateId)(input.courseId, "courseId");
-  if (!course.ok) throw new Error("normalizeDescriptor called with invalid courseId");
-  return {
-    ...input,
-    courseId: course.id,
-    title: input.title.trim(),
-    version: input.version?.trim() || void 0,
-    spaLessonId: input.spaLessonId?.trim() || void 0,
-    lessons: input.lessons.map((lesson) => {
-      const idResult = (0, import_core.validateId)(lesson.id, "lessonId");
-      if (!idResult.ok) throw new Error("normalizeDescriptor called with invalid lesson id");
-      return {
-        ...lesson,
-        id: idResult.id,
-        title: lesson.title.trim(),
-        spaPath: lesson.spaPath?.trim() || void 0
-      };
-    }),
-    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");
-      return {
-        ...assessment,
-        checkId: check.id,
-        question: assessment.question.trim(),
-        choices: assessment.choices.map((c) => c.trim()).filter((c) => c.length > 0),
-        answer: assessment.answer.trim()
-      };
-    })
-  };
-}
-function validateDescriptor(input) {
-  const parsed = parseCourseDescriptorInput(input);
-  if (parsed === null) {
-    return { ok: false, issues: [{ path: "course", message: "must be an object" }] };
-  }
-  return validateDescriptorParsed(parsed);
-}
-function validateDescriptorForTarget(input, target) {
-  const result = validateDescriptor(input);
-  if (!result.ok || !target) return result;
-  if (target !== "xapi" && target !== "cmi5") return result;
-  const activityIri = result.descriptor.tracking?.xapi?.activityIri?.trim();
-  if (!activityIri) {
-    return {
-      ok: false,
-      issues: [
-        {
-          path: "course.tracking.xapi.activityIri",
-          message: "tracking.xapi.activityIri is required for xapi and cmi5 export targets"
-        }
-      ]
-    };
+};
+function validateAssessmentEntry(assessment, index, issues, checkIds) {
+  const path = `assessments[${index}]`;
+  const check = (0, import_core2.validateId)(assessment.checkId, `${path}.checkId`);
+  if (!check.ok) {
+    issues.push(...check.issues.map((i) => ({ path: i.path, message: i.message })));
+  } else if (checkIds.has(check.id)) {
+    issues.push({ path: `${path}.checkId`, message: "duplicate checkId" });
+  } else {
+    checkIds.add(check.id);
+  }
+  if (!assessment.question?.trim()) {
+    issues.push({ path: `${path}.question`, message: "question is required" });
+  }
+  const kind = assessment.kind ?? "mcq";
+  ASSESSMENT_VALIDATORS[kind](assessment, path, issues);
+  const passingScore = assessment.passingScore;
+  if (passingScore !== void 0 && !(Number.isFinite(passingScore) && passingScore > 0)) {
+    issues.push({
+      path: `${path}.passingScore`,
+      message: "passingScore must be greater than 0 (absolute point threshold)"
+    });
   }
-  return result;
 }
-function validateDescriptorParsed(input) {
+
+// src/descriptor/validateCourse.ts
+var VALID_LAYOUTS = ["single-spa", "per-lesson-spa"];
+var VALID_THEME_PRESETS = ["default", "light", "dark", "brand"];
+function validateCourseDescriptor(input) {
   const issues = [];
-  const course = (0, import_core.validateId)(input.courseId, "courseId");
+  const course = (0, import_core3.validateId)(input.courseId, "courseId");
   if (!course.ok) issues.push(...course.issues.map((i) => ({ path: i.path, message: i.message })));
   if (!input.title?.trim()) {
     issues.push({ path: "title", message: "title is required" });
@@ -327,7 +443,7 @@ function validateDescriptorParsed(input) {
   const spaPaths = /* @__PURE__ */ new Set();
   for (const [index, lesson] of (input.lessons ?? []).entries()) {
     const path = `lessons[${index}]`;
-    const lessonResult = (0, import_core.validateId)(lesson.id, `${path}.id`);
+    const lessonResult = (0, import_core3.validateId)(lesson.id, `${path}.id`);
     if (!lessonResult.ok) {
       issues.push(...lessonResult.issues.map((i) => ({ path: i.path, message: i.message })));
     } else if (lessonIds.has(lessonResult.id)) {
@@ -359,7 +475,7 @@ function validateDescriptorParsed(input) {
   }
   if (layout === "single-spa" && input.spaLessonId?.trim()) {
     const spaId = input.spaLessonId.trim();
-    const spaResult = (0, import_core.validateId)(spaId, "spaLessonId");
+    const spaResult = (0, import_core3.validateId)(spaId, "spaLessonId");
     if (!spaResult.ok) {
       issues.push(...spaResult.issues.map((i) => ({ path: i.path, message: i.message })));
     } else if (!lessonIds.has(spaResult.id)) {
@@ -371,41 +487,48 @@ function validateDescriptorParsed(input) {
   }
   const checkIds = /* @__PURE__ */ new Set();
   for (const [index, assessment] of (input.assessments ?? []).entries()) {
-    const path = `assessments[${index}]`;
-    const check = (0, import_core.validateId)(assessment.checkId, `${path}.checkId`);
-    if (!check.ok) {
-      issues.push(...check.issues.map((i) => ({ path: i.path, message: i.message })));
-    } else if (checkIds.has(check.id)) {
-      issues.push({ path: `${path}.checkId`, message: "duplicate checkId" });
-    } else {
-      checkIds.add(check.id);
-    }
-    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 passingScore = assessment.passingScore;
-    if (passingScore !== void 0 && !(Number.isFinite(passingScore) && passingScore > 0)) {
-      issues.push({
-        path: `${path}.passingScore`,
-        message: "passingScore must be greater than 0 (absolute point threshold)"
-      });
-    }
+    validateAssessmentEntry(assessment, index, issues, checkIds);
   }
+  return issues;
+}
+
+// src/descriptor/validateForTarget.ts
+function validateDescriptorForExportTarget(descriptor, target) {
+  if (target !== "xapi" && target !== "cmi5") return [];
+  const activityIri = descriptor.tracking?.xapi?.activityIri?.trim();
+  if (!activityIri) {
+    return [
+      {
+        path: "course.tracking.xapi.activityIri",
+        message: "tracking.xapi.activityIri is required for xapi and cmi5 export targets"
+      }
+    ];
+  }
+  return [];
+}
+
+// src/validateDescriptor.ts
+function validateDescriptorParsed(input) {
+  const issues = validateCourseDescriptor(input);
   if (issues.length) return { ok: false, issues };
   return { ok: true, descriptor: normalizeDescriptor(input) };
 }
+function validateDescriptor(input) {
+  const parsed = parseCourseDescriptorInput(input);
+  if (parsed === null) {
+    return { ok: false, issues: [{ path: "course", message: "must be an object" }] };
+  }
+  return validateDescriptorParsed(parsed);
+}
+function validateDescriptorForTarget(input, target) {
+  const result = validateDescriptor(input);
+  if (!result.ok || !target) return result;
+  const targetIssues = validateDescriptorForExportTarget(result.descriptor, target);
+  if (targetIssues.length) {
+    return { ok: false, issues: targetIssues };
+  }
+  return result;
+}
 
 // src/validateProjectPaths.ts
 var import_node_path2 = require("path");
@@ -460,12 +583,12 @@ function resolveSafePackageOutputOverride(projectRoot, override) {
 }
 
 // src/mapIds.ts
-var import_core2 = require("@lessonkit/core");
+var import_core4 = require("@lessonkit/core");
 function mapLessonkitIds(descriptor) {
-  const courseId = (0, import_core2.assertValidId)(descriptor.courseId, "courseId");
-  const lessonIds = descriptor.lessons.map((l) => (0, import_core2.assertValidId)(l.id, "lessonId"));
+  const courseId = (0, import_core4.assertValidId)(descriptor.courseId, "courseId");
+  const lessonIds = descriptor.lessons.map((l) => (0, import_core4.assertValidId)(l.id, "lessonId"));
   const checkIds = (descriptor.assessments ?? []).map(
-    (a) => (0, import_core2.assertValidId)(a.checkId, "checkId")
+    (a) => (0, import_core4.assertValidId)(a.checkId, "checkId")
   );
   return { courseId, lessonIds, checkIds };
 }
@@ -476,7 +599,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 +620,43 @@ 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 (kind === "findHotspot" && assessment.kind === "findHotspot") {
+    return mcqToLxpack({
+      kind: "mcq",
+      checkId: assessment.checkId,
+      question: assessment.question,
+      choices: [assessment.correctTargetId, "other"],
+      answer: assessment.correctTargetId,
+      passingScore: assessment.passingScore
+    });
+  }
+  if (kind === "findMultipleHotspots") {
+    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 +729,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 +745,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 +830,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 +870,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 +888,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 +985,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 +1004,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 +1015,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 +1089,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 +1158,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 +1179,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 +1284,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
       });
     }