@lessonkit/cli 1.3.1 → 1.5.0

package/README.md

@@ -4,25 +4,37 @@
 [![Documentation](https://readthedocs.org/projects/lessonkit/badge/?version=latest)](https://lessonkit.readthedocs.io/en/latest/reference/cli.html)
 [![License](https://img.shields.io/github/license/eddiethedean/lessonkit)](https://github.com/eddiethedean/lessonkit/blob/main/LICENSE)
 
-Scaffold, develop, build, and package LessonKit courses. Node.js **18+**.
+Scaffold, develop, build, and package LessonKit courses.
 
 ## Install
 
 ```bash
 npm install -g @lessonkit/cli
-# or one-shot:
+# or one-shot (recommended for new courses):
 npx @lessonkit/cli init my-course
 ```
 
+**Node.js:** **20.19+** recommended for `init` (Vite 8 scaffold). **18+** minimum for `dev`, `build`, and `package`.
+
 ## Commands
 
 ```bash
-lessonkit init my-course    # scaffold Vite + React project
+lessonkit init my-course    # scaffold Vite + React project (runs npm install)
 lessonkit dev               # Vite dev server
 lessonkit build             # production build → dist/
 lessonkit package --target scorm12   # LMS artifact
 ```
 
+### Init flags
+
+| Flag | Purpose |
+| --- | --- |
+| `--here` | Scaffold in the current directory |
+| `--force` | Overwrite existing files in the target directory |
+| `--skip-install` | Skip `npm install` after copying the template |
+
+### Package targets
+
 | Target | Output |
 | --- | --- |
 | `react-vite` | Vite build only |
@@ -32,11 +44,20 @@ lessonkit package --target scorm12   # LMS artifact
 
 Every project includes a root `lessonkit.json` manifest (`schemaVersion: 1`).
 
-Subprocess timeout defaults to **30 minutes** (`LESSONKIT_CMD_TIMEOUT_MS`). To disable the timeout, pass `timeoutMs: 0` in the exec API (the env var falls back to 30 minutes when set to `0` or omitted).
+Subprocess timeout defaults to **30 minutes** (`LESSONKIT_CMD_TIMEOUT_MS`).
+
+## Common issues
+
+| Symptom | Fix |
+| --- | --- |
+| `lessonkit: command not found` | Use `npx @lessonkit/cli` or `npm run dev` in a scaffolded project |
+| `init` fails on Node version | Use Node **20.19+** for Vite 8 scaffold |
+| SCORM zip not at project root | Default path: `.lxpack/course/.lxpack/out/course-scorm12.zip` — trust CLI stdout |
+| ID parity errors on `package` | Align `courseId`, `lessonId`, `checkId` between React and `lessonkit.json` |
 
 ## Docs
 
-[CLI reference](https://lessonkit.readthedocs.io/en/latest/reference/cli.html) · [Packaging guide](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/packaging-and-cli.html) · [Template source](https://github.com/eddiethedean/lessonkit/tree/main/templates/vite-react)
+[5-minute guide](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/getting-started-in-5-minutes.html) · [CLI reference](https://lessonkit.readthedocs.io/en/latest/reference/cli.html) · [Ship to LMS checklist](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/ship-to-lms.html) · [Packaging guide](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/packaging-and-cli.html) · [Published template](https://github.com/eddiethedean/lessonkit/tree/main/packages/cli/template/vite-react) (monorepo source: [`templates/vite-react`](https://github.com/eddiethedean/lessonkit/tree/main/templates/vite-react))
 
 ## License
 

package/dist/bin.js

@@ -6,8 +6,9 @@ import { Command } from "commander";
 
 // src/commands/init.ts
 import { slugifyId } from "@lessonkit/core";
-import { cp, mkdir, readdir, readFile, writeFile } from "fs/promises";
+import { cp, mkdir, readdir, readFile, rename, rm, writeFile } from "fs/promises";
 import { existsSync } from "fs";
+import { randomUUID } from "crypto";
 import { basename, dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
 
@@ -124,7 +125,7 @@ async function runNpmInstall(cwd) {
 }
 
 // src/commands/init.ts
-var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", ".lxpack", ".git"]);
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", ".lxpack", ".git", "coverage", ".nyc_output"]);
 var SKIP_FILES = /* @__PURE__ */ new Set([".DS_Store"]);
 function getTemplateDir() {
   const thisDir = dirname(fileURLToPath(import.meta.url));
@@ -137,18 +138,13 @@ function getTemplateDir() {
   }
   return candidates[0];
 }
-async function isDirEmpty(dir) {
-  if (!existsSync(dir)) return true;
-  const entries = await readdir(dir);
-  return entries.length === 0;
-}
 async function isDirEmptyOrDotfilesOnly(dir) {
   if (!existsSync(dir)) return true;
   const entries = await readdir(dir);
   return entries.every((name) => name.startsWith("."));
 }
 function escapeJsxString(value) {
-  return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\{/g, "\\{").replace(/\}/g, "\\}").replace(/</g, "\\u003c").replace(/\r\n|\n|\r/g, "\\n");
+  return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\{/g, "\\{").replace(/\}/g, "\\}").replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029").replace(/\r\n|\n|\r/g, "\\n");
 }
 async function copyTemplate(src, dest) {
   await mkdir(dest, { recursive: true });
@@ -169,7 +165,7 @@ async function applyTemplateSubstitutions(projectDir, projectName, slug) {
   const pkgPath = join(projectDir, "package.json");
   const lessonkitPath = join(projectDir, "lessonkit.json");
   const pkg = JSON.parse(await readFile(pkgPath, "utf8"));
-  pkg.name = projectName;
+  pkg.name = slug;
   await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
   const lessonkit = JSON.parse(await readFile(lessonkitPath, "utf8"));
@@ -177,14 +173,37 @@ async function applyTemplateSubstitutions(projectDir, projectName, slug) {
   const course = lessonkit.course;
   course.courseId = slug;
   course.title = projectName;
+  const courseTracking = course.tracking ?? {};
+  const courseXapi = courseTracking.xapi ?? {};
+  courseXapi.activityIri = `https://example.com/courses/${slug}`;
+  courseTracking.xapi = courseXapi;
+  course.tracking = courseTracking;
   await writeFile(lessonkitPath, `${JSON.stringify(lessonkit, null, 2)}
 `, "utf8");
+  const courseConfigPath = join(projectDir, "src", "courseConfig.ts");
+  let courseConfigSource = await readFile(courseConfigPath, "utf8");
+  courseConfigSource = courseConfigSource.replace(/courseId: "my-course"/g, `courseId: "${slug}"`);
+  await writeFile(courseConfigPath, courseConfigSource, "utf8");
   const appPath = join(projectDir, "src", "App.tsx");
   let appSource = await readFile(appPath, "utf8");
   appSource = appSource.replace(/courseId="my-course"/g, `courseId="${slug}"`);
   appSource = appSource.replace(/\{\{courseTitle\}\}/g, escapeJsxString(projectName));
   await writeFile(appPath, appSource, "utf8");
 }
+async function promoteStagingToProjectDir(stagingDir, projectDir) {
+  await mkdir(projectDir, { recursive: true });
+  const entries = await readdir(stagingDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = join(stagingDir, entry.name);
+    const destPath = join(projectDir, entry.name);
+    if (entry.isDirectory()) {
+      await cp(srcPath, destPath, { recursive: true });
+    } else if (entry.isFile()) {
+      await cp(srcPath, destPath);
+    } else {
+    }
+  }
+}
 async function runInit(opts, logger) {
   const cwd = process.cwd();
   const rawName = opts.name ?? (opts.here ? slugifyId(basename(process.cwd()) || "my-course") : void 0);
@@ -212,7 +231,7 @@ async function runInit(opts, logger) {
       }
     );
   }
-  if (opts.here && !await isDirEmpty(projectDir) && !opts.force) {
+  if (opts.here && !await isDirEmptyOrDotfilesOnly(projectDir) && !opts.force) {
     throw new CliError(`Directory is not empty: ${projectDir}. Use --force to initialize anyway.`, {
       code: "INVALID_PROJECT",
       exitCode: EXIT_INVALID_PROJECT
@@ -234,11 +253,26 @@ async function runInit(opts, logger) {
       exitCode: EXIT_INVALID_PROJECT
     });
   }
-  await copyTemplate(templateDir, projectDir);
-  await applyTemplateSubstitutions(projectDir, projectName, slug);
-  if (!opts.skipInstall) {
-    if (!opts.json) logger.log(`Installing dependencies in ${projectDir}\u2026`);
-    await runNpmInstall(projectDir);
+  const stagingDir = opts.here ? join(cwd, `.lessonkit-init-${randomUUID()}`) : join(cwd, `.${slug}-init-${randomUUID()}`);
+  try {
+    await copyTemplate(templateDir, stagingDir);
+    await applyTemplateSubstitutions(stagingDir, projectName, slug);
+    if (!opts.skipInstall) {
+      if (!opts.json) logger.log(`Installing dependencies in ${stagingDir}\u2026`);
+      await runNpmInstall(stagingDir);
+    }
+    if (opts.here) {
+      await promoteStagingToProjectDir(stagingDir, projectDir);
+      await rm(stagingDir, { recursive: true, force: true });
+    } else {
+      await rename(stagingDir, projectDir);
+    }
+  } catch (err) {
+    await rm(stagingDir, { recursive: true, force: true }).catch(
+      /* v8 ignore next */
+      () => void 0
+    );
+    throw err;
   }
   if (!opts.json) {
     logger.log(`Created LessonKit project at ${projectDir}`);
@@ -247,6 +281,10 @@ async function runInit(opts, logger) {
   return { ok: true, command: "init", projectRoot: projectDir };
 }
 
+// src/commands/dev.ts
+import { existsSync as existsSync3 } from "fs";
+import { join as join3 } from "path";
+
 // src/lib/project.ts
 import { readFileSync, existsSync as existsSync2 } from "fs";
 import { readFile as readFile2 } from "fs/promises";
@@ -442,13 +480,24 @@ function resolvePackageOutput(project, target, override) {
   }
   return { output: `${outputBaseDir}/course-${target}.zip`, dir: false, outputBaseDir };
 }
-var DEFAULT_SPA_DIST_DIR = "dist";
-function resolveViteBuildArgs(project) {
-  const args = ["build"];
-  if (project.paths.spaDistDir !== DEFAULT_SPA_DIST_DIR) {
-    args.push("--outDir", project.paths.spaDistDir);
+function stripOutDirFromViteArgs(viteArgs) {
+  const stripped = [];
+  for (let i = 0; i < viteArgs.length; i++) {
+    const arg = viteArgs[i];
+    if (arg === "--outDir" || arg === "-o") {
+      i++;
+      continue;
+    }
+    if (arg.startsWith("--outDir=")) {
+      continue;
+    }
+    stripped.push(arg);
   }
-  return args;
+  return stripped;
+}
+function resolveViteBuildArgv(project, viteArgs = []) {
+  const passthrough = stripOutDirFromViteArgs(viteArgs);
+  return ["build", ...passthrough, "--outDir", project.paths.spaDistDir];
 }
 function parsePackageTarget(value) {
   if (!value) {
@@ -477,15 +526,24 @@ async function runBuild(opts) {
   const pkg = await readPackageJson(project.root);
   assertViteProject(pkg, project.root);
   const viteJs = resolveViteJs(project.root);
-  const buildArgs = resolveViteBuildArgs(project);
-  await runCommand(process.execPath, [viteJs, ...buildArgs, ...opts.viteArgs ?? []], {
+  const buildArgs = resolveViteBuildArgv(project, opts.viteArgs);
+  await runCommand(process.execPath, [viteJs, ...buildArgs], {
     cwd: project.root
   });
+  const distDir = resolveDistDir(project);
+  const indexHtml = join3(distDir, "index.html");
+  if (!existsSync3(indexHtml)) {
+    throw new CliError(
+      `Build did not produce index.html at ${indexHtml}. Check paths.spaDistDir in lessonkit.json.`,
+      { code: "INVALID_PROJECT", exitCode: EXIT_INVALID_PROJECT }
+    );
+  }
   return { ok: true, command: "build", projectRoot: project.root };
 }
 
 // src/commands/package.ts
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
+import { isAbsolute } from "path";
 import { packageLessonkitCourse } from "@lessonkit/lxpack";
 async function runPackage(opts) {
   let target;
@@ -503,7 +561,7 @@ async function runPackage(opts) {
   }
   const project = await loadProject(opts.cwd ?? process.cwd());
   const distDir = resolveDistDir(project);
-  if (opts.noBuild && !existsSync3(distDir)) {
+  if (opts.noBuild && !existsSync4(distDir)) {
     throw new CliError(
       `dist directory not found at ${distDir}. Run lessonkit build before packaging with --no-build.`,
       {
@@ -516,7 +574,7 @@ async function runPackage(opts) {
     if (!opts.noBuild) {
       await runBuild({ cwd: project.root, json: opts.json });
     }
-    if (!existsSync3(distDir)) {
+    if (!existsSync4(distDir)) {
       throw new CliError(`Build completed but dist directory not found at ${distDir}.`, {
         code: "INVALID_PROJECT",
         exitCode: EXIT_INVALID_PROJECT
@@ -528,14 +586,20 @@ async function runPackage(opts) {
   if (!opts.noBuild) {
     await runBuild({ cwd: project.root, json: opts.json });
   }
-  if (!existsSync3(distDir)) {
+  if (!existsSync4(distDir)) {
     throw new CliError(`dist directory not found at ${distDir}. Run lessonkit build first.`, {
       code: "INVALID_PROJECT",
       exitCode: EXIT_INVALID_PROJECT
     });
   }
   const outDir = resolveLxpackOutDir(project);
-  const { output, dir, outputBaseDir } = resolvePackageOutput(project, target, opts.out);
+  const { output: resolvedOutput, dir, outputBaseDir } = resolvePackageOutput(
+    project,
+    target,
+    opts.out
+  );
+  const trimmedOut = opts.out?.trim();
+  const output = trimmedOut && !isAbsolute(trimmedOut) ? trimmedOut : resolvedOutput;
   const result = await packageLessonkitCourse({
     descriptor: project.course,
     outDir,
@@ -544,7 +608,8 @@ async function runPackage(opts) {
     target,
     output,
     dir,
-    outputBaseDir
+    outputBaseDir,
+    strictParity: opts.strictParity
   });
   if (!result.ok) {
     throw new CliError("Packaging failed.", {
@@ -647,7 +712,7 @@ function createProgram(baseLogger = console) {
       );
     }
   );
-  program.command("package").description("Build or package for web / LMS delivery").requiredOption("--target <target>", `Export target (${PACKAGE_TARGETS.join(", ")})`).option("--cwd <dir>", "Project root directory").option("--no-build", "Skip implicit Vite build for LMS targets").option("--out <path>", "Override output artifact path").option("--json", "Emit structured JSON result").action(async (opts) => {
+  program.command("package").description("Build or package for web / LMS delivery").requiredOption("--target <target>", `Export target (${PACKAGE_TARGETS.join(", ")})`).option("--cwd <dir>", "Project root directory").option("--no-build", "Skip implicit Vite build for LMS targets").option("--out <path>", "Override output artifact path").option("--strict-parity", "Treat React ID parity warnings as packaging errors").option("--json", "Emit structured JSON result").action(async (opts) => {
     const logger = createLogger({ json: opts.json });
     await handleCommand(
       async () => {
@@ -656,7 +721,8 @@ function createProgram(baseLogger = console) {
           cwd: opts.cwd,
           noBuild: opts.build === false,
           out: opts.out,
-          json: opts.json
+          json: opts.json,
+          strictParity: opts.strictParity
         });
         if (!opts.json && result.ok && result.command === "package") {
           if (result.target === "react-vite") {
@@ -674,8 +740,10 @@ function createProgram(baseLogger = console) {
       Boolean(opts.json)
     );
   });
-  program.command("publish").description("Publish package artifacts (stub)").action(() => {
-    baseLogger.log("lessonkit publish is not implemented. See RELEASING.md for npm publish workflow.");
+  program.command("publish").description("[maintainers] Not implemented \u2014 use Changesets (see RELEASING.md)").action(() => {
+    baseLogger.log(
+      "lessonkit publish is not implemented. Monorepo releases use Changesets: npm run changeset && npm run version-packages && npm run release. See RELEASING.md."
+    );
   });
   return program;
 }

package/dist/index.d.ts

@@ -5,7 +5,14 @@ type CliLogger = {
     error: (...args: unknown[]) => void;
 };
 
+/**
+ * Build the Commander program used by the `lessonkit` CLI binary.
+ * Useful for embedding init/build/package in Node scripts and tests.
+ */
 declare function createProgram(baseLogger?: CliLogger): Command;
+/**
+ * Parse argv and run the LessonKit CLI (same as the `lessonkit` binary entrypoint).
+ */
 declare function run(argv?: string[], logger?: CliLogger): Promise<void>;
 
 export { type CliLogger, createProgram, run };

package/dist/index.js

@@ -4,8 +4,9 @@ import { Command } from "commander";
 
 // src/commands/init.ts
 import { slugifyId } from "@lessonkit/core";
-import { cp, mkdir, readdir, readFile, writeFile } from "fs/promises";
+import { cp, mkdir, readdir, readFile, rename, rm, writeFile } from "fs/promises";
 import { existsSync } from "fs";
+import { randomUUID } from "crypto";
 import { basename, dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
 
@@ -122,7 +123,7 @@ async function runNpmInstall(cwd) {
 }
 
 // src/commands/init.ts
-var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", ".lxpack", ".git"]);
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", ".lxpack", ".git", "coverage", ".nyc_output"]);
 var SKIP_FILES = /* @__PURE__ */ new Set([".DS_Store"]);
 function getTemplateDir() {
   const thisDir = dirname(fileURLToPath(import.meta.url));
@@ -135,18 +136,13 @@ function getTemplateDir() {
   }
   return candidates[0];
 }
-async function isDirEmpty(dir) {
-  if (!existsSync(dir)) return true;
-  const entries = await readdir(dir);
-  return entries.length === 0;
-}
 async function isDirEmptyOrDotfilesOnly(dir) {
   if (!existsSync(dir)) return true;
   const entries = await readdir(dir);
   return entries.every((name) => name.startsWith("."));
 }
 function escapeJsxString(value) {
-  return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\{/g, "\\{").replace(/\}/g, "\\}").replace(/</g, "\\u003c").replace(/\r\n|\n|\r/g, "\\n");
+  return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\{/g, "\\{").replace(/\}/g, "\\}").replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029").replace(/\r\n|\n|\r/g, "\\n");
 }
 async function copyTemplate(src, dest) {
   await mkdir(dest, { recursive: true });
@@ -167,7 +163,7 @@ async function applyTemplateSubstitutions(projectDir, projectName, slug) {
   const pkgPath = join(projectDir, "package.json");
   const lessonkitPath = join(projectDir, "lessonkit.json");
   const pkg = JSON.parse(await readFile(pkgPath, "utf8"));
-  pkg.name = projectName;
+  pkg.name = slug;
   await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
   const lessonkit = JSON.parse(await readFile(lessonkitPath, "utf8"));
@@ -175,14 +171,37 @@ async function applyTemplateSubstitutions(projectDir, projectName, slug) {
   const course = lessonkit.course;
   course.courseId = slug;
   course.title = projectName;
+  const courseTracking = course.tracking ?? {};
+  const courseXapi = courseTracking.xapi ?? {};
+  courseXapi.activityIri = `https://example.com/courses/${slug}`;
+  courseTracking.xapi = courseXapi;
+  course.tracking = courseTracking;
   await writeFile(lessonkitPath, `${JSON.stringify(lessonkit, null, 2)}
 `, "utf8");
+  const courseConfigPath = join(projectDir, "src", "courseConfig.ts");
+  let courseConfigSource = await readFile(courseConfigPath, "utf8");
+  courseConfigSource = courseConfigSource.replace(/courseId: "my-course"/g, `courseId: "${slug}"`);
+  await writeFile(courseConfigPath, courseConfigSource, "utf8");
   const appPath = join(projectDir, "src", "App.tsx");
   let appSource = await readFile(appPath, "utf8");
   appSource = appSource.replace(/courseId="my-course"/g, `courseId="${slug}"`);
   appSource = appSource.replace(/\{\{courseTitle\}\}/g, escapeJsxString(projectName));
   await writeFile(appPath, appSource, "utf8");
 }
+async function promoteStagingToProjectDir(stagingDir, projectDir) {
+  await mkdir(projectDir, { recursive: true });
+  const entries = await readdir(stagingDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = join(stagingDir, entry.name);
+    const destPath = join(projectDir, entry.name);
+    if (entry.isDirectory()) {
+      await cp(srcPath, destPath, { recursive: true });
+    } else if (entry.isFile()) {
+      await cp(srcPath, destPath);
+    } else {
+    }
+  }
+}
 async function runInit(opts, logger) {
   const cwd = process.cwd();
   const rawName = opts.name ?? (opts.here ? slugifyId(basename(process.cwd()) || "my-course") : void 0);
@@ -210,7 +229,7 @@ async function runInit(opts, logger) {
       }
     );
   }
-  if (opts.here && !await isDirEmpty(projectDir) && !opts.force) {
+  if (opts.here && !await isDirEmptyOrDotfilesOnly(projectDir) && !opts.force) {
     throw new CliError(`Directory is not empty: ${projectDir}. Use --force to initialize anyway.`, {
       code: "INVALID_PROJECT",
       exitCode: EXIT_INVALID_PROJECT
@@ -232,11 +251,26 @@ async function runInit(opts, logger) {
       exitCode: EXIT_INVALID_PROJECT
     });
   }
-  await copyTemplate(templateDir, projectDir);
-  await applyTemplateSubstitutions(projectDir, projectName, slug);
-  if (!opts.skipInstall) {
-    if (!opts.json) logger.log(`Installing dependencies in ${projectDir}\u2026`);
-    await runNpmInstall(projectDir);
+  const stagingDir = opts.here ? join(cwd, `.lessonkit-init-${randomUUID()}`) : join(cwd, `.${slug}-init-${randomUUID()}`);
+  try {
+    await copyTemplate(templateDir, stagingDir);
+    await applyTemplateSubstitutions(stagingDir, projectName, slug);
+    if (!opts.skipInstall) {
+      if (!opts.json) logger.log(`Installing dependencies in ${stagingDir}\u2026`);
+      await runNpmInstall(stagingDir);
+    }
+    if (opts.here) {
+      await promoteStagingToProjectDir(stagingDir, projectDir);
+      await rm(stagingDir, { recursive: true, force: true });
+    } else {
+      await rename(stagingDir, projectDir);
+    }
+  } catch (err) {
+    await rm(stagingDir, { recursive: true, force: true }).catch(
+      /* v8 ignore next */
+      () => void 0
+    );
+    throw err;
   }
   if (!opts.json) {
     logger.log(`Created LessonKit project at ${projectDir}`);
@@ -245,6 +279,10 @@ async function runInit(opts, logger) {
   return { ok: true, command: "init", projectRoot: projectDir };
 }
 
+// src/commands/dev.ts
+import { existsSync as existsSync3 } from "fs";
+import { join as join3 } from "path";
+
 // src/lib/project.ts
 import { readFileSync, existsSync as existsSync2 } from "fs";
 import { readFile as readFile2 } from "fs/promises";
@@ -440,13 +478,24 @@ function resolvePackageOutput(project, target, override) {
   }
   return { output: `${outputBaseDir}/course-${target}.zip`, dir: false, outputBaseDir };
 }
-var DEFAULT_SPA_DIST_DIR = "dist";
-function resolveViteBuildArgs(project) {
-  const args = ["build"];
-  if (project.paths.spaDistDir !== DEFAULT_SPA_DIST_DIR) {
-    args.push("--outDir", project.paths.spaDistDir);
+function stripOutDirFromViteArgs(viteArgs) {
+  const stripped = [];
+  for (let i = 0; i < viteArgs.length; i++) {
+    const arg = viteArgs[i];
+    if (arg === "--outDir" || arg === "-o") {
+      i++;
+      continue;
+    }
+    if (arg.startsWith("--outDir=")) {
+      continue;
+    }
+    stripped.push(arg);
   }
-  return args;
+  return stripped;
+}
+function resolveViteBuildArgv(project, viteArgs = []) {
+  const passthrough = stripOutDirFromViteArgs(viteArgs);
+  return ["build", ...passthrough, "--outDir", project.paths.spaDistDir];
 }
 function parsePackageTarget(value) {
   if (!value) {
@@ -475,15 +524,24 @@ async function runBuild(opts) {
   const pkg = await readPackageJson(project.root);
   assertViteProject(pkg, project.root);
   const viteJs = resolveViteJs(project.root);
-  const buildArgs = resolveViteBuildArgs(project);
-  await runCommand(process.execPath, [viteJs, ...buildArgs, ...opts.viteArgs ?? []], {
+  const buildArgs = resolveViteBuildArgv(project, opts.viteArgs);
+  await runCommand(process.execPath, [viteJs, ...buildArgs], {
     cwd: project.root
   });
+  const distDir = resolveDistDir(project);
+  const indexHtml = join3(distDir, "index.html");
+  if (!existsSync3(indexHtml)) {
+    throw new CliError(
+      `Build did not produce index.html at ${indexHtml}. Check paths.spaDistDir in lessonkit.json.`,
+      { code: "INVALID_PROJECT", exitCode: EXIT_INVALID_PROJECT }
+    );
+  }
   return { ok: true, command: "build", projectRoot: project.root };
 }
 
 // src/commands/package.ts
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
+import { isAbsolute } from "path";
 import { packageLessonkitCourse } from "@lessonkit/lxpack";
 async function runPackage(opts) {
   let target;
@@ -501,7 +559,7 @@ async function runPackage(opts) {
   }
   const project = await loadProject(opts.cwd ?? process.cwd());
   const distDir = resolveDistDir(project);
-  if (opts.noBuild && !existsSync3(distDir)) {
+  if (opts.noBuild && !existsSync4(distDir)) {
     throw new CliError(
       `dist directory not found at ${distDir}. Run lessonkit build before packaging with --no-build.`,
       {
@@ -514,7 +572,7 @@ async function runPackage(opts) {
     if (!opts.noBuild) {
       await runBuild({ cwd: project.root, json: opts.json });
     }
-    if (!existsSync3(distDir)) {
+    if (!existsSync4(distDir)) {
       throw new CliError(`Build completed but dist directory not found at ${distDir}.`, {
         code: "INVALID_PROJECT",
         exitCode: EXIT_INVALID_PROJECT
@@ -526,14 +584,20 @@ async function runPackage(opts) {
   if (!opts.noBuild) {
     await runBuild({ cwd: project.root, json: opts.json });
   }
-  if (!existsSync3(distDir)) {
+  if (!existsSync4(distDir)) {
     throw new CliError(`dist directory not found at ${distDir}. Run lessonkit build first.`, {
       code: "INVALID_PROJECT",
       exitCode: EXIT_INVALID_PROJECT
     });
   }
   const outDir = resolveLxpackOutDir(project);
-  const { output, dir, outputBaseDir } = resolvePackageOutput(project, target, opts.out);
+  const { output: resolvedOutput, dir, outputBaseDir } = resolvePackageOutput(
+    project,
+    target,
+    opts.out
+  );
+  const trimmedOut = opts.out?.trim();
+  const output = trimmedOut && !isAbsolute(trimmedOut) ? trimmedOut : resolvedOutput;
   const result = await packageLessonkitCourse({
     descriptor: project.course,
     outDir,
@@ -542,7 +606,8 @@ async function runPackage(opts) {
     target,
     output,
     dir,
-    outputBaseDir
+    outputBaseDir,
+    strictParity: opts.strictParity
   });
   if (!result.ok) {
     throw new CliError("Packaging failed.", {
@@ -645,7 +710,7 @@ function createProgram(baseLogger = console) {
       );
     }
   );
-  program.command("package").description("Build or package for web / LMS delivery").requiredOption("--target <target>", `Export target (${PACKAGE_TARGETS.join(", ")})`).option("--cwd <dir>", "Project root directory").option("--no-build", "Skip implicit Vite build for LMS targets").option("--out <path>", "Override output artifact path").option("--json", "Emit structured JSON result").action(async (opts) => {
+  program.command("package").description("Build or package for web / LMS delivery").requiredOption("--target <target>", `Export target (${PACKAGE_TARGETS.join(", ")})`).option("--cwd <dir>", "Project root directory").option("--no-build", "Skip implicit Vite build for LMS targets").option("--out <path>", "Override output artifact path").option("--strict-parity", "Treat React ID parity warnings as packaging errors").option("--json", "Emit structured JSON result").action(async (opts) => {
     const logger = createLogger({ json: opts.json });
     await handleCommand(
       async () => {
@@ -654,7 +719,8 @@ function createProgram(baseLogger = console) {
           cwd: opts.cwd,
           noBuild: opts.build === false,
           out: opts.out,
-          json: opts.json
+          json: opts.json,
+          strictParity: opts.strictParity
         });
         if (!opts.json && result.ok && result.command === "package") {
           if (result.target === "react-vite") {
@@ -672,8 +738,10 @@ function createProgram(baseLogger = console) {
       Boolean(opts.json)
     );
   });
-  program.command("publish").description("Publish package artifacts (stub)").action(() => {
-    baseLogger.log("lessonkit publish is not implemented. See RELEASING.md for npm publish workflow.");
+  program.command("publish").description("[maintainers] Not implemented \u2014 use Changesets (see RELEASING.md)").action(() => {
+    baseLogger.log(
+      "lessonkit publish is not implemented. Monorepo releases use Changesets: npm run changeset && npm run version-packages && npm run release. See RELEASING.md."
+    );
   });
   return program;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessonkit/cli",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "private": false,
   "description": "LessonKit CLI — init, dev, build, and package learning experiences.",
   "license": "Apache-2.0",
@@ -25,7 +25,10 @@
     "lessonkit": "./dist/bin.js"
   },
   "exports": {
-    ".": "./dist/index.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
   },
   "files": [
     "dist",
@@ -39,20 +42,20 @@
     "typecheck": "tsc -p tsconfig.json",
     "test": "vitest run --passWithNoTests",
     "test:coverage": "vitest run --coverage --passWithNoTests=false",
-    "lint": "echo \"(no lint configured yet)\""
+    "lint": "eslint --max-warnings 0 \"src/**/*.{ts,tsx}\" \"test/**/*.{ts,tsx}\""
   },
   "dependencies": {
-    "@lessonkit/core": "1.3.1",
-    "@lessonkit/lxpack": "1.3.1",
-    "commander": "^14.0.1"
+    "@lessonkit/core": "1.5.0",
+    "@lessonkit/lxpack": "1.5.0",
+    "commander": "^15.0.0"
   },
   "engines": {
     "node": ">=18"
   },
   "devDependencies": {
-    "@types/node": "^24.0.0",
+    "@types/node": "^25.9.2",
     "tsup": "^8.5.0",
-    "typescript": "^5.8.3",
+    "typescript": "^6.0.3",
     "vitest": "^4.1.8"
   }
 }

package/template/vite-react/.env.example

@@ -0,0 +1,8 @@
+# Copy to `.env` for production LMS export (see courseConfig.ts).
+# Never commit real secrets — use short-lived tokens from your backend.
+
+# Analytics batch ingest proxy (createFetchBatchSink)
+VITE_ANALYTICS_URL=
+
+# xAPI statement proxy (createFetchTransport)
+VITE_XAPI_PROXY_URL=

package/template/vite-react/README.md

@@ -14,8 +14,39 @@ npm run package:scorm12
 ## Files
 
 - `src/App.tsx` — course UI (IDs match `lessonkit.json`)
+- `src/courseConfig.ts` — production transports, observability hooks, and LMS bridge config
+- `.env.example` — `VITE_XAPI_PROXY_URL` and `VITE_ANALYTICS_URL` for production builds
 - `lessonkit.json` — manifest for CLI and LXPack packaging
 
+## Before LMS packaging
+
+1. **LMS bridge** — In `src/courseConfig.ts`, enable the bridge for SCORM/xAPI/cmi5 export (template defaults to `"off"` for local preview):
+
+   ```ts
+   lxpack: {
+     bridge: "auto",
+     allowedParentOrigins: ["https://your-lms.example"], // required in production builds
+   },
+   ```
+
+   Development builds allow `bridge: "auto"` without an allowlist; **production builds do not**. Discover your LMS origin from the SCORM preview URL or browser devtools (`document.referrer`).
+
+2. **Production runtime** — Copy `.env.example` to `.env`, set `VITE_ANALYTICS_URL` and `VITE_XAPI_PROXY_URL`, and wire the observability hooks in `courseConfig.ts` (see comments there). Rebuild with `npm run build` before packaging. Alternatively, disable `tracking` and `xapi` for a first test export only.
+
+3. **Activity IRI** — Replace the `example.com` placeholder in `lessonkit.json` → `course.tracking.xapi.activityIri` before xAPI/cmi5 export (must be HTTPS).
+
+## SCORM output path
+
+After `npm run package:scorm12`, the CLI prints the resolved ZIP path. Default:
+
+**`.lxpack/course/.lxpack/out/course-scorm12.zip`**
+
+(`paths.outputBaseDir` is resolved inside `paths.lxpackOutDir`, not at the project root.)
+
+## Production
+
+Copy `.env.example` to `.env` and set your LRS/analytics proxy URLs before `npm run build`. See the [production checklist](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/production-checklist.html) and [Ship to LMS checklist](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/ship-to-lms.html).
+
 ## Docs
 
-[CLI reference](https://lessonkit.readthedocs.io/en/latest/reference/cli.html) · [React quickstart](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/quickstart.html) · [Packaging guide](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/packaging-and-cli.html)
+[5-minute guide](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/getting-started-in-5-minutes.html) · [First LMS export](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/first-lms-export.html) · [CLI reference](https://lessonkit.readthedocs.io/en/latest/reference/cli.html) · [Packaging guide](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/packaging-and-cli.html)

package/template/vite-react/package.json

@@ -7,29 +7,33 @@
     "build": "lessonkit build",
     "preview": "vite preview",
     "package:scorm12": "lessonkit package --target scorm12",
+    "package:scorm2004": "lessonkit package --target scorm2004",
     "package:standalone": "lessonkit package --target standalone",
+    "package:xapi": "lessonkit package --target xapi",
+    "package:cmi5": "lessonkit package --target cmi5",
     "typecheck": "tsc -p tsconfig.json",
     "test": "vitest run --passWithNoTests",
     "test:coverage": "vitest run --coverage --passWithNoTests=false"
   },
   "dependencies": {
-    "@lessonkit/core": "^1.3.1",
-    "@lessonkit/react": "^1.3.1",
-    "@lessonkit/themes": "^1.3.1",
-    "@lessonkit/xapi": "^1.3.1",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1"
+    "@lessonkit/core": "^1.5.0",
+    "@lessonkit/react": "^1.5.0",
+    "@lessonkit/themes": "^1.5.0",
+    "@lessonkit/xapi": "^1.5.0",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7"
   },
   "devDependencies": {
-    "@lessonkit/cli": "^1.3.1",
-    "@lessonkit/lxpack": "^1.3.1",
+    "@lessonkit/cli": "^1.5.0",
+    "@lessonkit/lxpack": "^1.5.0",
     "@testing-library/react": "^16.3.0",
-    "@types/react": "^18.3.23",
-    "@types/react-dom": "^18.3.7",
-    "@vitejs/plugin-react": "^4.6.0",
-    "jsdom": "^26.1.0",
-    "typescript": "^5.8.3",
-    "vite": "^7.1.3",
+    "@testing-library/dom": "^10.4.1",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.2",
+    "jsdom": "^29.1.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.11",
     "vitest": "^4.1.8"
   }
 }

package/template/vite-react/src/App.test.tsx

@@ -1,14 +1,14 @@
 import React from "react";
 import { describe, expect, it, vi } from "vitest";
-import { render } from "@testing-library/react";
+import { render, screen } from "@testing-library/react";
 import App from "./App";
 
 describe("template App", () => {
-  it("renders without crashing", () => {
+  it("renders the starter quiz question", () => {
     const spy = vi.spyOn(console, "log").mockImplementation(() => {});
     render(<App />);
+    expect(screen.getByText("Ready to build?")).toBeDefined();
     spy.mockRestore();
-    expect(true).toBe(true);
   });
 });
 

package/template/vite-react/src/App.tsx

@@ -1,24 +1,12 @@
 import React from "react";
 import { Course, Lesson, Quiz, Scenario, ThemeProvider } from "@lessonkit/react";
-import type { TelemetryEvent } from "@lessonkit/core";
-import type { XAPIStatement } from "@lessonkit/xapi";
+import { createCourseConfig, COURSE_THEME_PRESET } from "./courseConfig";
 
-const courseConfig = {
-  tracking: {
-    sink: (event: TelemetryEvent) => {
-      console.log("[telemetry]", event);
-    },
-  },
-  xapi: {
-    transport: (statement: XAPIStatement) => {
-      console.log("[xapi]", statement);
-    },
-  },
-} as const;
+const courseConfig = createCourseConfig();
 
 export default function App() {
   return (
-    <ThemeProvider preset="default" mode="light">
+    <ThemeProvider preset={COURSE_THEME_PRESET} mode="light">
       <div className="app-shell">
         <Course title="{{courseTitle}}" courseId="my-course" config={courseConfig}>
           <Lesson title="My first lesson" lessonId="lesson-1">

package/template/vite-react/src/courseConfig.test.ts

@@ -0,0 +1,93 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import type { TelemetryEvent } from "@lessonkit/core";
+import { createCourseConfig } from "./courseConfig";
+
+describe("createCourseConfig", () => {
+  const originalFetch = globalThis.fetch;
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
+    globalThis.fetch = originalFetch;
+  });
+
+  it("returns dev console sinks when proxy URLs are unset", () => {
+    const log = vi.spyOn(console, "log").mockImplementation(() => undefined);
+    const config = createCourseConfig();
+
+    expect(config.courseId).toBe("my-course");
+    expect(config.lxpack?.bridge).toBe("off");
+    expect(config.observability?.onTelemetrySinkError).toBeTypeOf("function");
+    expect(config.observability?.onLxpackBridgeMiss).toBeTypeOf("function");
+
+    config.tracking?.sink?.({
+      name: "interaction",
+      timestamp: "2026-01-01T00:00:00Z",
+      courseId: "my-course",
+    } as TelemetryEvent);
+    expect(log).toHaveBeenCalledWith("[telemetry]", expect.any(Object));
+
+    log.mockRestore();
+  });
+
+  it("invokes observability hooks without throwing", () => {
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => undefined);
+    const config = createCourseConfig();
+
+    config.observability?.onTelemetrySinkError?.(new Error("sink"), { sinkId: "tracking" });
+    config.observability?.onTelemetryBufferDrop?.();
+    config.observability?.onXapiQueueDepth?.(10);
+    config.observability?.onXapiQueueDepth?.(60);
+    config.observability?.onXapiQueueCap?.();
+    config.observability?.onLxpackBridgeMiss?.({
+      name: "course_completed",
+      timestamp: "2026-01-01T00:00:00Z",
+      courseId: "my-course",
+    } as TelemetryEvent);
+    config.observability?.onXapiTransportError?.(new Error("transport"));
+    config.observability?.onXapiMappingError?.(new Error("mapping"));
+    config.observability?.onLxpackBridgeError?.(new Error("bridge"));
+
+    expect(warn).toHaveBeenCalled();
+    warn.mockRestore();
+  });
+
+  it("uses fetch transports when proxy URLs are set", async () => {
+    vi.stubEnv("VITE_XAPI_PROXY_URL", "https://lrs.example/statements");
+    vi.stubEnv("VITE_ANALYTICS_URL", "https://analytics.example/events");
+    const fetchMock = vi.fn(() => Promise.resolve(new Response(null, { status: 204 })));
+    globalThis.fetch = fetchMock as typeof fetch;
+
+    const config = createCourseConfig();
+
+    expect(config.tracking?.batchSink).toBeTypeOf("function");
+    expect(config.xapi?.transport).toBeTypeOf("function");
+
+    await config.tracking?.batchSink?.([
+      { name: "course_started", timestamp: "t", courseId: "my-course" } as TelemetryEvent,
+    ]);
+    await config.xapi?.transport?.({
+      id: "s1",
+      timestamp: "2026-01-01T00:00:00Z",
+      verb: "http://adlnet.gov/expapi/verbs/completed",
+      object: { id: "https://example.com/a" },
+    });
+
+    expect(fetchMock).toHaveBeenCalled();
+  });
+
+  it("skips production guard when MODE is test even with proxy URLs set", () => {
+    vi.stubEnv("NODE_ENV", "production");
+    vi.stubEnv("MODE", "test");
+    vi.stubEnv("VITE_XAPI_PROXY_URL", "https://lrs.example/statements");
+    vi.stubEnv("VITE_ANALYTICS_URL", "https://analytics.example/events");
+
+    expect(() => createCourseConfig()).not.toThrow();
+  });
+
+  it("throws when production guard is enforced with console sinks", () => {
+    vi.stubEnv("NODE_ENV", "production");
+    vi.stubEnv("MODE", "production");
+
+    expect(() => createCourseConfig()).toThrow(/console telemetry sinks|observability hooks/);
+  });
+});

package/template/vite-react/src/courseConfig.ts

@@ -0,0 +1,127 @@
+import type { TelemetryEvent } from "@lessonkit/core";
+import type { LessonkitConfig } from "@lessonkit/react";
+import { assertProductionCourseConfig, shouldEnforceProductionGuard } from "@lessonkit/react";
+import { createFetchBatchSink, createFetchTransport } from "@lessonkit/xapi";
+import type { XAPIStatement } from "@lessonkit/xapi";
+
+/**
+ * Replace with your backend token proxy. Never ship static LRS passwords in the bundle.
+ * Example: fetch("/api/lrs-token") and return { Authorization: `Bearer ${token}` }.
+ */
+function lrsAuthHeaders(): Record<string, string> {
+  return {};
+}
+
+function createObservability(): NonNullable<LessonkitConfig["observability"]> {
+  const report = (channel: string, detail: unknown) => {
+    if (import.meta.env.DEV) {
+      console.warn(`[lessonkit:${channel}]`, detail);
+      return;
+    }
+    // Wire to your monitoring stack (Sentry, Datadog, etc.).
+    /* v8 ignore next -- production-only; swap for your APM in go-live builds */
+    console.error(`[lessonkit:${channel}]`, detail);
+  };
+
+  return {
+    onTelemetrySinkError: (err, ctx) => report("telemetry-sink", { err, ...ctx }),
+    onTelemetryBufferDrop: () => report("telemetry-buffer-cap", {}),
+    onXapiQueueDepth: (depth) => {
+      if (depth > 50) report("xapi-queue-depth", { depth });
+    },
+    onXapiQueueCap: () => report("xapi-queue-cap", {}),
+    onLxpackBridgeMiss: (event) => report("lxpack-bridge-miss", { event: event.name }),
+    onLxpackBridgeError: (err) => report("lxpack-bridge-error", { err }),
+    onXapiTransportError: (err) => report("xapi-transport", { err }),
+    onXapiMappingError: (err) => report("xapi-mapping", { err }),
+  };
+}
+
+function readProxyUrls(): { xapiProxyUrl?: string; analyticsUrl?: string } {
+  return {
+    xapiProxyUrl: import.meta.env.VITE_XAPI_PROXY_URL as string | undefined,
+    analyticsUrl: import.meta.env.VITE_ANALYTICS_URL as string | undefined,
+  };
+}
+
+function devConsoleTracking(): LessonkitConfig["tracking"] {
+  return {
+    sink: (event: TelemetryEvent) => {
+      console.log("[telemetry]", event);
+    },
+  };
+}
+
+function devConsoleXapi(): LessonkitConfig["xapi"] {
+  return {
+    enabled: true,
+    transport: (statement: XAPIStatement) => {
+      console.log("[xapi]", statement);
+      return Promise.resolve();
+    },
+  };
+}
+
+function productionTracking(analyticsUrl: string | undefined): LessonkitConfig["tracking"] {
+  if (!analyticsUrl) {
+    /* v8 ignore next */
+    throw new Error(
+      "VITE_ANALYTICS_URL is required in production. Point it at your analytics ingest proxy.",
+    );
+  }
+  const { batchSink, exitBatchSink } = createFetchBatchSink({
+    url: analyticsUrl,
+    headers: lrsAuthHeaders,
+  });
+  return {
+    enabled: true,
+    batchSink,
+    exitBatchSink,
+    batch: { enabled: true },
+  };
+}
+
+function productionXapi(xapiProxyUrl: string | undefined): LessonkitConfig["xapi"] {
+  if (!xapiProxyUrl) {
+    /* v8 ignore next */
+    throw new Error(
+      "VITE_XAPI_PROXY_URL is required in production. Point it at your LRS proxy (never the raw LRS with embedded secrets).",
+    );
+  }
+  const { transport, exitTransport, abortInFlight } = createFetchTransport({
+    url: xapiProxyUrl,
+    headers: lrsAuthHeaders,
+  });
+  return {
+    enabled: true,
+    transport,
+    exitTransport,
+    abortInFlight,
+  };
+}
+
+/** Theme preset — keep in sync with lessonkit.json `course.theme.preset`. */
+export const COURSE_THEME_PRESET = "default" as const;
+
+export function createCourseConfig(): LessonkitConfig {
+  const { xapiProxyUrl, analyticsUrl } = readProxyUrls();
+  const useProductionTransports = import.meta.env.PROD || (xapiProxyUrl && analyticsUrl);
+
+  const config: LessonkitConfig = {
+    courseId: "my-course",
+    lxpack: {
+      // Set bridge: "auto" when packaging for LMS (SCORM/xAPI/cmi5). In production, allowedParentOrigins
+      // is required — see https://lessonkit.readthedocs.io/en/latest/guides/react-developers/production-checklist.html
+      bridge: "off",
+      // allowedParentOrigins: ["https://your-lms.example"],
+    },
+    observability: createObservability(),
+    tracking: useProductionTransports ? productionTracking(analyticsUrl) : devConsoleTracking(),
+    xapi: useProductionTransports ? productionXapi(xapiProxyUrl) : devConsoleXapi(),
+  };
+
+  if (shouldEnforceProductionGuard()) {
+    assertProductionCourseConfig(config);
+  }
+  return config;
+}

package/template/vite-react/src/vite-env.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="vite/client" />
+
+declare module "*.css";

package/template/vite-react/vitest.config.ts

@@ -8,7 +8,7 @@ export default defineConfig({
       provider: "v8",
       include: ["src/**/*.{ts,tsx}"],
       exclude: ["dist/**", "node_modules/**", "**/*.d.ts", "**/*.d.cts"],
-      thresholds: { statements: 85, branches: 85, functions: 85, lines: 85 },
+      thresholds: { statements: 85, branches: 80, functions: 85, lines: 85 },
     },
   },
 });