@lessonkit/lxpack 0.8.1 → 0.9.1

package/dist/index.cjs

@@ -30,14 +30,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  LESSONKIT_TELEMETRY_EVENTS: () => import_tracking_schema2.LESSONKIT_TELEMETRY_EVENTS,
   assessmentDescriptorToLxpack: () => assessmentDescriptorToLxpack,
   buildLessonkitProject: () => buildLessonkitProject,
   descriptorToInterchange: () => descriptorToInterchange,
   extractAssessments: () => extractAssessments,
+  lessonkitInterchangeSchema: () => import_validators2.lessonkitInterchangeSchema,
   mapLessonkitIds: () => mapLessonkitIds,
+  mapLessonkitTelemetryToBridgeAction: () => import_tracking_schema2.mapLessonkitTelemetryToBridgeAction,
+  mapLessonkitTelemetryToLxpack: () => import_tracking_schema2.mapLessonkitTelemetryToLxpack,
+  materializeLessonkitProject: () => import_validators2.materializeLessonkitProject,
   packageLessonkitCourse: () => packageLessonkitCourse,
+  parseLessonkitInterchange: () => import_validators2.parseLessonkitInterchange,
   resolveSafePackageOutputOverride: () => resolveSafePackageOutputOverride,
   resolveSpaLessons: () => resolveSpaLessons,
+  telemetryEventToLessonkit: () => telemetryEventToLessonkit,
   themeToLxpackRuntime: () => themeToLxpackRuntime,
   validateDescriptor: () => validateDescriptor,
   validateLessonkitProject: () => validateLessonkitProject,
@@ -316,6 +323,37 @@ function mapLessonkitIds(descriptor) {
   return { courseId, lessonIds, checkIds };
 }
 
+// src/assessments.ts
+function slugChoiceId(text, index) {
+  const base = text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 32);
+  const stem = base.length ? base : "choice";
+  return `${stem}-${index + 1}`;
+}
+function assessmentDescriptorToLxpack(assessment) {
+  const choices = assessment.choices.map((text, index) => {
+    const id = slugChoiceId(text, index);
+    return {
+      id,
+      text,
+      correct: text === assessment.answer
+    };
+  });
+  return {
+    id: assessment.checkId,
+    passingScore: assessment.passingScore ?? 1,
+    questions: [
+      {
+        id: "q1",
+        prompt: assessment.question,
+        choices
+      }
+    ]
+  };
+}
+function extractAssessments(descriptor) {
+  return (descriptor.assessments ?? []).map(assessmentDescriptorToLxpack);
+}
+
 // src/interchange.ts
 function resolveSpaLessons(descriptor) {
   const mapped = mapLessonkitIds(descriptor);
@@ -339,6 +377,8 @@ function resolveSpaLessons(descriptor) {
 function descriptorToInterchange(descriptor) {
   const mapped = mapLessonkitIds(descriptor);
   const spaLessons = resolveSpaLessons(descriptor);
+  const runtime = descriptor.theme ? themeToLxpackRuntime(descriptor.theme) : void 0;
+  const assessments = extractAssessments(descriptor);
   return {
     format: "lessonkit",
     version: "1",
@@ -352,121 +392,52 @@ function descriptorToInterchange(descriptor) {
       type: "spa",
       path: l.path
     })),
-    tracking: descriptor.tracking
+    tracking: descriptor.tracking,
+    runtime: runtime ? {
+      theme: runtime.theme,
+      cssVariables: runtime.cssVariables
+    } : void 0,
+    assessments: assessments.length ? assessments : void 0
   };
 }
 
-// src/assessments.ts
-function slugChoiceId(text, index) {
-  const base = text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 32);
-  const stem = base.length ? base : "choice";
-  return `${stem}-${index + 1}`;
-}
-function assessmentDescriptorToLxpack(assessment) {
-  const choices = assessment.choices.map((text, index) => {
-    const id = slugChoiceId(text, index);
-    return {
-      id,
-      text,
-      correct: text === assessment.answer
-    };
-  });
-  return {
-    id: assessment.checkId,
-    passingScore: assessment.passingScore ?? 1,
-    questions: [
-      {
-        id: "q1",
-        prompt: assessment.question,
-        choices
-      }
-    ]
-  };
-}
-function extractAssessments(descriptor) {
-  return (descriptor.assessments ?? []).map(assessmentDescriptorToLxpack);
-}
-
 // src/writeProject.ts
+var import_node_path4 = require("path");
+var import_validators = require("@lxpack/validators");
+
+// src/spaDirs.ts
 var import_promises = require("fs/promises");
 var import_node_path3 = require("path");
-
-// src/assessmentYaml.ts
-function yamlQuote(value) {
-  return JSON.stringify(value);
-}
-function emitAssessmentYaml(assessment) {
-  const lx = assessmentDescriptorToLxpack(assessment);
-  const lines = [];
-  lines.push(`id: ${lx.id}`);
-  lines.push(`passingScore: ${lx.passingScore}`);
-  lines.push("questions:");
-  for (const question of lx.questions) {
-    lines.push(`  - id: ${question.id}`);
-    lines.push(`    prompt: ${yamlQuote(question.prompt)}`);
-    lines.push("    choices:");
-    for (const choice of question.choices) {
-      lines.push(`      - id: ${choice.id}`);
-      lines.push(`        text: ${yamlQuote(choice.text)}`);
-      if (choice.correct) lines.push("        correct: true");
+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 srcDist = projectRoot ? (0, import_node_path3.resolve)(projectRoot, spaDistRelative) : (0, import_node_path3.resolve)(spaDistRelative);
+    if (projectRoot) {
+      assertResolvedPathUnderRoot((0, import_node_path3.resolve)(projectRoot), srcDist);
     }
-  }
-  return `${lines.join("\n")}
-`;
-}
-
-// src/yaml.ts
-function yamlQuote2(value) {
-  if (/[:#\n\r]/.test(value) || value.startsWith(" ") || value.endsWith(" ")) {
-    return JSON.stringify(value);
-  }
-  return value;
-}
-function emitCourseYaml(opts) {
-  const lines = [];
-  lines.push(`title: ${yamlQuote2(opts.title)}`);
-  lines.push(`version: ${yamlQuote2(opts.version)}`);
-  if (opts.description) lines.push(`description: ${yamlQuote2(opts.description)}`);
-  if (opts.runtime) {
-    lines.push("runtime:");
-    lines.push(`  theme: ${yamlQuote2(opts.runtime.theme)}`);
-    if (opts.runtime.cssVariables && Object.keys(opts.runtime.cssVariables).length) {
-      lines.push("  cssVariables:");
-      for (const [key, value] of Object.entries(opts.runtime.cssVariables).sort(
-        ([a], [b]) => a.localeCompare(b)
-      )) {
-        lines.push(`    ${key}: ${JSON.stringify(String(value))}`);
-      }
+    try {
+      await (0, import_promises.access)(srcDist);
+    } catch {
+      throw new Error(`spaDistDir not found: ${srcDist}`);
     }
-  }
-  if (opts.tracking?.completion?.threshold !== void 0) {
-    lines.push("tracking:");
-    lines.push("  completion:");
-    lines.push(`    threshold: ${opts.tracking.completion.threshold}`);
-  }
-  lines.push("lessons:");
-  for (const lesson of opts.lessons) {
-    lines.push(`  - id: ${lesson.id}`);
-    lines.push(`    title: ${yamlQuote2(lesson.title)}`);
-    lines.push(`    type: spa`);
-    lines.push(`    path: ${lesson.path}`);
-  }
-  if (opts.assessments.length) {
-    lines.push("assessments:");
-    for (const assessment of opts.assessments) {
-      lines.push(`  - id: ${assessment.id}`);
-      lines.push(`    file: ${assessment.file}`);
+    const lessonId = spaLessons[0]?.id ?? "main";
+    return { [lessonId]: srcDist };
+  }
+  const dirs = {};
+  const lessonDirs = lessonSpaDirs ?? {};
+  for (const lesson of descriptor.lessons) {
+    const src = lessonDirs[lesson.id];
+    if (!src) {
+      throw new Error(`lessonSpaDirs missing build output for lesson "${lesson.id}"`);
     }
+    dirs[lesson.id] = (0, import_node_path3.resolve)(src);
   }
-  return `${lines.join("\n")}
-`;
+  return dirs;
 }
 
 // src/writeProject.ts
-async function copyDir(src, dest) {
-  await (0, import_promises.mkdir)((0, import_node_path3.dirname)(dest), { recursive: true });
-  await (0, import_promises.cp)(src, dest, { recursive: true });
-}
 async function writeLxpackProject(options) {
   const validation = validateDescriptor(options.descriptor);
   if (!validation.ok) {
@@ -475,94 +446,42 @@ async function writeLxpackProject(options) {
     );
   }
   const descriptor = validation.descriptor;
-  const outDir = (0, import_node_path3.resolve)(options.outDir);
-  await (0, import_promises.mkdir)(outDir, { recursive: true });
-  const spaLessons = resolveSpaLessons(descriptor);
-  const runtime = descriptor.theme ? themeToLxpackRuntime(descriptor.theme) : void 0;
-  const assessments = (descriptor.assessments ?? []).map((a) => ({
-    id: a.checkId,
-    file: `assessments/${a.checkId}.yaml`
-  }));
-  if (descriptor.layout === "single-spa") {
-    const spaDistRelative = options.spaDistDir ?? descriptor.spaDistDir ?? "dist";
-    const srcDist = options.projectRoot ? (0, import_node_path3.resolve)(options.projectRoot, spaDistRelative) : (0, import_node_path3.resolve)(spaDistRelative);
-    if (options.projectRoot) {
-      assertResolvedPathUnderRoot((0, import_node_path3.resolve)(options.projectRoot), srcDist);
-    }
-    try {
-      await (0, import_promises.access)(srcDist);
-    } catch {
-      throw new Error(`spaDistDir not found: ${srcDist}`);
-    }
-    const destDist = (0, import_node_path3.join)(outDir, "dist");
-    await (0, import_promises.rm)(destDist, { recursive: true, force: true });
-    await copyDir(srcDist, destDist);
-  } else {
-    const lessonDirs = options.lessonSpaDirs ?? {};
-    for (const lesson of descriptor.lessons) {
-      const src = lessonDirs[lesson.id];
-      if (!src) {
-        throw new Error(`lessonSpaDirs missing build output for lesson "${lesson.id}"`);
-      }
-      const dest = (0, import_node_path3.join)(outDir, lesson.spaPath);
-      assertResolvedPathUnderRoot(outDir, dest);
-      await (0, import_promises.rm)(dest, { recursive: true, force: true });
-      await copyDir((0, import_node_path3.resolve)(src), dest);
-    }
-  }
-  if (assessments.length) {
-    const assessmentsDir = (0, import_node_path3.join)(outDir, "assessments");
-    await (0, import_promises.mkdir)(assessmentsDir, { recursive: true });
-    for (const assessment of descriptor.assessments ?? []) {
-      await (0, import_promises.writeFile)(
-        (0, import_node_path3.join)(outDir, `assessments/${assessment.checkId}.yaml`),
-        emitAssessmentYaml(assessment),
-        "utf-8"
-      );
-    }
+  const outDir = (0, import_node_path4.resolve)(options.outDir);
+  const spaDirs = await resolveSpaDirs({ ...options, descriptor });
+  const interchange = descriptorToInterchange(descriptor);
+  const materialized = await (0, import_validators.materializeLessonkitProject)({
+    interchange,
+    spaDirs,
+    courseDir: outDir,
+    writeAuthoringFiles: true
+  });
+  if (!materialized.ok) {
+    throw new Error(
+      materialized.issues.map((i) => `${i.path ?? ""}: ${i.message}`.trim()).join("; ")
+    );
   }
-  const courseYamlPath = (0, import_node_path3.join)(outDir, "course.yaml");
-  await (0, import_promises.writeFile)(
-    courseYamlPath,
-    emitCourseYaml({
-      title: descriptor.title,
-      version: descriptor.version ?? "1.0.0",
-      runtime,
-      tracking: descriptor.tracking,
-      lessons: spaLessons.map((l) => ({
-        id: l.id,
-        title: l.title,
-        type: "spa",
-        path: l.path
-      })),
-      assessments
-    }),
-    "utf-8"
-  );
-  const lessonkitJsonPath = (0, import_node_path3.join)(outDir, "lessonkit.json");
-  await (0, import_promises.writeFile)(
-    lessonkitJsonPath,
-    `${JSON.stringify(descriptorToInterchange(descriptor), null, 2)}
-`,
-    "utf-8"
-  );
-  return { outDir, courseYamlPath, lessonkitJsonPath };
+  const courseDir = materialized.courseDir;
+  return {
+    outDir: courseDir,
+    courseYamlPath: (0, import_node_path4.join)(courseDir, "course.yaml"),
+    lessonkitJsonPath: (0, import_node_path4.join)(courseDir, "lessonkit.json")
+  };
 }
 
 // src/packageCourse.ts
 var fsp = __toESM(require("fs/promises"), 1);
-var import_node_path4 = require("path");
+var import_node_path5 = require("path");
 var import_node_os = require("os");
 var import_api = require("@lxpack/api");
 async function validateLessonkitProject(options) {
   return (0, import_api.validateCourse)({
-    courseDir: (0, import_node_path4.resolve)(options.courseDir),
+    courseDir: (0, import_node_path5.resolve)(options.courseDir),
     target: options.target
   });
 }
 async function buildLessonkitProject(options) {
   return (0, import_api.buildCourse)({
-    courseDir: (0, import_node_path4.resolve)(options.courseDir),
+    courseDir: (0, import_node_path5.resolve)(options.courseDir),
     target: options.target,
     output: options.output,
     dir: options.dir,
@@ -601,7 +520,7 @@ async function promoteStagingToOutDir(stagingDir, outDir) {
 }
 async function packageLessonkitCourse(options) {
   const { target, output, dir, outputBaseDir, ...writeOpts } = options;
-  const outDir = (0, import_node_path4.resolve)(writeOpts.outDir);
+  const outDir = (0, import_node_path5.resolve)(writeOpts.outDir);
   const descriptorValidation = validateDescriptor(writeOpts.descriptor);
   if (!descriptorValidation.ok) {
     return {
@@ -615,42 +534,50 @@ async function packageLessonkitCourse(options) {
     };
   }
   const descriptor = descriptorValidation.descriptor;
-  const stagingDir = await fsp.mkdtemp((0, import_node_path4.join)((0, import_node_os.tmpdir)(), "lessonkit-lxpack-"));
+  const stagingDir = await fsp.mkdtemp((0, import_node_path5.join)((0, import_node_os.tmpdir)(), "lessonkit-lxpack-"));
   let promoted = false;
   try {
-    const written = await writeLxpackProject({ ...writeOpts, descriptor, outDir: stagingDir });
-    const courseDir = written.outDir;
-    const assessments = extractAssessments(descriptor);
-    const validation = await validateLessonkitProject({ courseDir, target });
-    if (!validation.ok) {
+    let spaDirs;
+    try {
+      spaDirs = await resolveSpaDirs({ ...writeOpts, descriptor });
+    } catch (err) {
       return {
         ok: false,
         courseDir: outDir,
         target,
-        validation,
-        issues: validation.issues.map((i) => ({
-          path: i.path,
-          message: i.message,
-          severity: i.severity
-        }))
+        issues: [
+          {
+            path: "spaDirs",
+            message: err instanceof Error ? err.message : String(err)
+          }
+        ]
       };
     }
+    const interchange = descriptorToInterchange(descriptor);
     const outputBase = outputBaseDir ?? ".lxpack/out";
-    await fsp.mkdir((0, import_node_path4.join)(courseDir, outputBase), { recursive: true });
-    const defaultOutput = output ?? (dir ? (0, import_node_path4.join)(outputBase, target) : (0, import_node_path4.join)(outputBase, `course-${target}.zip`));
-    const build = await buildLessonkitProject({
-      courseDir,
+    await fsp.mkdir((0, import_node_path5.join)(stagingDir, outputBase), { recursive: true });
+    const defaultOutput = output ?? (dir ? (0, import_node_path5.join)(outputBase, target) : (0, import_node_path5.join)(outputBase, `course-${target}.zip`));
+    const build = await (0, import_api.packageLessonkit)({
+      interchange,
+      spaDirs,
       target,
-      output: defaultOutput.startsWith("/") ? defaultOutput : (0, import_node_path4.join)(courseDir, defaultOutput),
+      courseDir: stagingDir,
+      output: defaultOutput,
       dir,
-      assessments: assessments.length ? assessments : void 0
+      outputBaseDir,
+      outputAnchorDir: stagingDir,
+      writeAuthoringFiles: true
     });
     if (!build.ok) {
+      const validation2 = {
+        ok: false,
+        issues: build.issues
+      };
       return {
         ok: false,
         courseDir: outDir,
         target,
-        validation,
+        validation: validation2,
         build,
         issues: build.issues.map((i) => ({
           path: i.path,
@@ -659,15 +586,17 @@ async function packageLessonkitCourse(options) {
         }))
       };
     }
-    await fsp.mkdir((0, import_node_path4.dirname)(outDir), { recursive: true });
-    await promoteStagingToOutDir(stagingDir, outDir);
-    promoted = true;
+    const validation = {
+      ok: true,
+      manifest: build.manifest,
+      issues: build.issues
+    };
+    const stagingRoot = await fsp.realpath(stagingDir);
     const remapArtifactPath = (artifactPath) => {
       if (!artifactPath) return void 0;
-      const resolved = (0, import_node_path4.resolve)(artifactPath);
-      const stagingResolved = (0, import_node_path4.resolve)(stagingDir);
-      if (resolved === stagingResolved || resolved.startsWith(stagingResolved + "/")) {
-        return (0, import_node_path4.join)(outDir, resolved.slice(stagingResolved.length + 1));
+      const resolved = (0, import_node_path5.resolve)(artifactPath);
+      if (resolved === stagingRoot || resolved.startsWith(`${stagingRoot}/`)) {
+        return (0, import_node_path5.join)(outDir, resolved.slice(stagingRoot.length + 1));
       }
       return artifactPath;
     };
@@ -675,6 +604,9 @@ async function packageLessonkitCourse(options) {
       "outputPath" in build ? build.outputPath : void 0
     );
     const remappedOutputDir = remapArtifactPath("outputDir" in build ? build.outputDir : void 0);
+    await fsp.mkdir((0, import_node_path5.dirname)(outDir), { recursive: true });
+    await promoteStagingToOutDir(stagingDir, outDir);
+    promoted = true;
     const remappedBuild = { ...build };
     if ("outputPath" in remappedBuild && remappedOutputPath !== void 0) {
       remappedBuild.outputPath = remappedOutputPath;
@@ -698,16 +630,58 @@ async function packageLessonkitCourse(options) {
     }
   }
 }
+
+// src/index.ts
+var import_tracking_schema2 = require("@lxpack/tracking-schema");
+
+// src/telemetry.ts
+var import_tracking_schema = require("@lxpack/tracking-schema");
+var SUPPORTED = new Set(import_tracking_schema.LESSONKIT_TELEMETRY_EVENTS);
+function telemetryEventToLessonkit(event) {
+  if (!SUPPORTED.has(event.name)) {
+    return null;
+  }
+  const name = event.name;
+  const mapped = {
+    name,
+    lessonId: event.lessonId
+  };
+  if (name === "quiz_completed" || name === "quiz_answered") {
+    const data = event.data;
+    mapped.assessmentId = data?.checkId;
+    if (data && "score" in data) {
+      mapped.score = data.score;
+      mapped.maxScore = data.maxScore;
+      mapped.passingScore = data.passingScore;
+    }
+    if (data) {
+      mapped.data = data;
+    }
+  } else if (name === "interaction" && event.data) {
+    mapped.data = event.data;
+  }
+  return mapped;
+}
+
+// src/index.ts
+var import_validators2 = require("@lxpack/validators");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  LESSONKIT_TELEMETRY_EVENTS,
   assessmentDescriptorToLxpack,
   buildLessonkitProject,
   descriptorToInterchange,
   extractAssessments,
+  lessonkitInterchangeSchema,
   mapLessonkitIds,
+  mapLessonkitTelemetryToBridgeAction,
+  mapLessonkitTelemetryToLxpack,
+  materializeLessonkitProject,
   packageLessonkitCourse,
+  parseLessonkitInterchange,
   resolveSafePackageOutputOverride,
   resolveSpaLessons,
+  telemetryEventToLessonkit,
   themeToLxpackRuntime,
   validateDescriptor,
   validateLessonkitProject,

package/dist/index.d.cts

@@ -1,7 +1,11 @@
 import { CheckId, CourseId, LessonId } from '@lessonkit/core';
 import { ThemePresetName, LessonkitThemeV1 } from '@lessonkit/themes';
+import { LessonkitInterchangeV1 } from '@lxpack/validators';
+export { LessonkitInterchangeV1, MaterializeLessonkitOptions, MaterializeLessonkitResult, lessonkitInterchangeSchema, materializeLessonkitProject, parseLessonkitInterchange } from '@lxpack/validators';
 import { ExportTarget, ValidateCourseResult, BuildCourseResult } from '@lxpack/api';
 export { ExportTarget } from '@lxpack/api';
+export { LESSONKIT_TELEMETRY_EVENTS, LessonkitBridgeAction, LessonkitTelemetryEvent, LessonkitTelemetryEventName, TrackingSchemaEvent, mapLessonkitTelemetryToBridgeAction, mapLessonkitTelemetryToLxpack } from '@lxpack/tracking-schema';
+export { t as telemetryEventToLessonkit } from './telemetry-gCxlwc7I.cjs';
 
 type SpaLayout = "single-spa" | "per-lesson-spa";
 type LessonDescriptor = {
@@ -38,25 +42,7 @@ type LessonkitCourseDescriptor = {
     /** LXPack SPA lesson id for `single-spa` (default: first lesson id or `main`). */
     spaLessonId?: string;
 };
-type LessonkitInterchangeV1 = {
-    format: "lessonkit";
-    version: "1";
-    course: {
-        id: CourseId;
-        title: string;
-    };
-    lessons: Array<{
-        id: LessonId;
-        title: string;
-        type: "spa";
-        path: string;
-    }>;
-    tracking?: {
-        completion?: {
-            threshold?: number;
-        };
-    };
-};
+
 type MappedLessonkitIds = {
     courseId: CourseId;
     lessonIds: LessonId[];
@@ -149,6 +135,9 @@ type WriteLxpackProjectResult = {
     courseYamlPath: string;
     lessonkitJsonPath: string;
 };
+/**
+ * Materialize an LXPack project tree from a LessonKit descriptor (delegates to LXPack 0.6+).
+ */
 declare function writeLxpackProject(options: WriteLxpackProjectOptions): Promise<WriteLxpackProjectResult>;
 
 type ValidateLessonkitProjectOptions = {
@@ -195,4 +184,4 @@ declare function validateLessonkitProject(options: ValidateLessonkitProjectOptio
 declare function buildLessonkitProject(options: BuildLessonkitProjectOptions): Promise<BuildCourseResult>;
 declare function packageLessonkitCourse(options: PackageLessonkitCourseOptions): Promise<PackageLessonkitCourseResult>;
 
-export { type AssessmentDescriptor, type BuildLessonkitProjectOptions, type DescriptorValidationIssue, type DescriptorValidationResult, type LessonDescriptor, type LessonkitCourseDescriptor, type LessonkitInterchangeV1, type LxpackInjectedAssessment, type LxpackRuntimeTheme, type MappedLessonkitIds, type PackageLessonkitCourseOptions, type PackageLessonkitCourseResult, type ProjectPathsInput, type SpaLayout, type SpaLessonEntry, type ValidateLessonkitProjectOptions, type WriteLxpackProjectOptions, type WriteLxpackProjectResult, assessmentDescriptorToLxpack, buildLessonkitProject, descriptorToInterchange, extractAssessments, mapLessonkitIds, packageLessonkitCourse, resolveSafePackageOutputOverride, resolveSpaLessons, themeToLxpackRuntime, validateDescriptor, validateLessonkitProject, validateProjectPaths, writeLxpackProject };
+export { type AssessmentDescriptor, type BuildLessonkitProjectOptions, type DescriptorValidationIssue, type DescriptorValidationResult, type LessonDescriptor, type LessonkitCourseDescriptor, type LxpackInjectedAssessment, type LxpackRuntimeTheme, type MappedLessonkitIds, type PackageLessonkitCourseOptions, type PackageLessonkitCourseResult, type ProjectPathsInput, type SpaLayout, type SpaLessonEntry, type ValidateLessonkitProjectOptions, type WriteLxpackProjectOptions, type WriteLxpackProjectResult, assessmentDescriptorToLxpack, buildLessonkitProject, descriptorToInterchange, extractAssessments, mapLessonkitIds, packageLessonkitCourse, resolveSafePackageOutputOverride, resolveSpaLessons, themeToLxpackRuntime, validateDescriptor, validateLessonkitProject, validateProjectPaths, writeLxpackProject };

package/dist/index.d.ts

@@ -1,7 +1,11 @@
 import { CheckId, CourseId, LessonId } from '@lessonkit/core';
 import { ThemePresetName, LessonkitThemeV1 } from '@lessonkit/themes';
+import { LessonkitInterchangeV1 } from '@lxpack/validators';
+export { LessonkitInterchangeV1, MaterializeLessonkitOptions, MaterializeLessonkitResult, lessonkitInterchangeSchema, materializeLessonkitProject, parseLessonkitInterchange } from '@lxpack/validators';
 import { ExportTarget, ValidateCourseResult, BuildCourseResult } from '@lxpack/api';
 export { ExportTarget } from '@lxpack/api';
+export { LESSONKIT_TELEMETRY_EVENTS, LessonkitBridgeAction, LessonkitTelemetryEvent, LessonkitTelemetryEventName, TrackingSchemaEvent, mapLessonkitTelemetryToBridgeAction, mapLessonkitTelemetryToLxpack } from '@lxpack/tracking-schema';
+export { t as telemetryEventToLessonkit } from './telemetry-gCxlwc7I.js';
 
 type SpaLayout = "single-spa" | "per-lesson-spa";
 type LessonDescriptor = {
@@ -38,25 +42,7 @@ type LessonkitCourseDescriptor = {
     /** LXPack SPA lesson id for `single-spa` (default: first lesson id or `main`). */
     spaLessonId?: string;
 };
-type LessonkitInterchangeV1 = {
-    format: "lessonkit";
-    version: "1";
-    course: {
-        id: CourseId;
-        title: string;
-    };
-    lessons: Array<{
-        id: LessonId;
-        title: string;
-        type: "spa";
-        path: string;
-    }>;
-    tracking?: {
-        completion?: {
-            threshold?: number;
-        };
-    };
-};
+
 type MappedLessonkitIds = {
     courseId: CourseId;
     lessonIds: LessonId[];
@@ -149,6 +135,9 @@ type WriteLxpackProjectResult = {
     courseYamlPath: string;
     lessonkitJsonPath: string;
 };
+/**
+ * Materialize an LXPack project tree from a LessonKit descriptor (delegates to LXPack 0.6+).
+ */
 declare function writeLxpackProject(options: WriteLxpackProjectOptions): Promise<WriteLxpackProjectResult>;
 
 type ValidateLessonkitProjectOptions = {
@@ -195,4 +184,4 @@ declare function validateLessonkitProject(options: ValidateLessonkitProjectOptio
 declare function buildLessonkitProject(options: BuildLessonkitProjectOptions): Promise<BuildCourseResult>;
 declare function packageLessonkitCourse(options: PackageLessonkitCourseOptions): Promise<PackageLessonkitCourseResult>;
 
-export { type AssessmentDescriptor, type BuildLessonkitProjectOptions, type DescriptorValidationIssue, type DescriptorValidationResult, type LessonDescriptor, type LessonkitCourseDescriptor, type LessonkitInterchangeV1, type LxpackInjectedAssessment, type LxpackRuntimeTheme, type MappedLessonkitIds, type PackageLessonkitCourseOptions, type PackageLessonkitCourseResult, type ProjectPathsInput, type SpaLayout, type SpaLessonEntry, type ValidateLessonkitProjectOptions, type WriteLxpackProjectOptions, type WriteLxpackProjectResult, assessmentDescriptorToLxpack, buildLessonkitProject, descriptorToInterchange, extractAssessments, mapLessonkitIds, packageLessonkitCourse, resolveSafePackageOutputOverride, resolveSpaLessons, themeToLxpackRuntime, validateDescriptor, validateLessonkitProject, validateProjectPaths, writeLxpackProject };
+export { type AssessmentDescriptor, type BuildLessonkitProjectOptions, type DescriptorValidationIssue, type DescriptorValidationResult, type LessonDescriptor, type LessonkitCourseDescriptor, type LxpackInjectedAssessment, type LxpackRuntimeTheme, type MappedLessonkitIds, type PackageLessonkitCourseOptions, type PackageLessonkitCourseResult, type ProjectPathsInput, type SpaLayout, type SpaLessonEntry, type ValidateLessonkitProjectOptions, type WriteLxpackProjectOptions, type WriteLxpackProjectResult, assessmentDescriptorToLxpack, buildLessonkitProject, descriptorToInterchange, extractAssessments, mapLessonkitIds, packageLessonkitCourse, resolveSafePackageOutputOverride, resolveSpaLessons, themeToLxpackRuntime, validateDescriptor, validateLessonkitProject, validateProjectPaths, writeLxpackProject };