@lessonkit/cli 1.0.0 → 1.0.1

package/dist/bin.js

@@ -158,6 +158,12 @@ async function runInit(opts, logger) {
       exitCode: EXIT_INVALID_PROJECT
     });
   }
+  if (opts.force && !opts.here) {
+    throw new CliError("--force requires --here (initialize in the current directory).", {
+      code: "INVALID_PROJECT",
+      exitCode: EXIT_INVALID_PROJECT
+    });
+  }
   const slug = slugifyId(rawName ?? "my-course");
   const projectName = rawName ?? slug;
   const projectDir = opts.here ? cwd : resolve(cwd, slug);
@@ -253,11 +259,8 @@ async function loadLessonkitJson(projectRoot) {
     throwManifestCliError(configPath, parsed.issues);
   }
   return {
-    root: projectRoot,
-    schemaVersion: 1,
-    name: parsed.manifest.name,
-    course: parsed.manifest.course,
-    paths: parsed.manifest.paths
+    ...parsed.manifest,
+    root: projectRoot
   };
 }
 function throwManifestCliError(configPath, issues) {
@@ -360,6 +363,18 @@ function assertNode18ForLxpack() {
 // src/lib/paths.ts
 import { resolve as resolve3 } from "path";
 import { resolveSafePackageOutputOverride } from "@lessonkit/lxpack";
+
+// src/lib/targetTypes.ts
+var PACKAGE_TARGETS = [
+  "react-vite",
+  "scorm12",
+  "scorm2004",
+  "xapi",
+  "cmi5",
+  "standalone"
+];
+
+// src/lib/paths.ts
 function resolveDistDir(project) {
   return resolve3(project.root, project.paths.spaDistDir);
 }
@@ -390,14 +405,6 @@ function resolveViteBuildArgs(project) {
   }
   return args;
 }
-var PACKAGE_TARGETS = [
-  "react-vite",
-  "scorm12",
-  "scorm2004",
-  "xapi",
-  "cmi5",
-  "standalone"
-];
 function parsePackageTarget(value) {
   if (!value) {
     throw new Error("TARGET_REQUIRED");
@@ -448,8 +455,17 @@ async function runPackage(opts) {
   }
   const project = await loadProject(opts.cwd ?? process.cwd());
   const distDir = resolveDistDir(project);
+  if (opts.noBuild && !existsSync3(distDir)) {
+    throw new CliError(
+      `dist directory not found at ${distDir}. Run lessonkit build before packaging with --no-build.`,
+      {
+        code: "INVALID_PROJECT",
+        exitCode: EXIT_INVALID_PROJECT
+      }
+    );
+  }
   if (target === "react-vite") {
-    if (!opts.noBuild || !existsSync3(distDir)) {
+    if (!opts.noBuild) {
       await runBuild({ cwd: project.root, json: opts.json });
     }
     if (!existsSync3(distDir)) {
@@ -458,10 +474,10 @@ async function runPackage(opts) {
         exitCode: EXIT_INVALID_PROJECT
       });
     }
-    return { ok: true, target, projectRoot: project.root, distDir };
+    return { ok: true, command: "package", target, projectRoot: project.root, distDir };
   }
   assertNode18ForLxpack();
-  if (!opts.noBuild || !existsSync3(distDir)) {
+  if (!opts.noBuild) {
     await runBuild({ cwd: project.root, json: opts.json });
   }
   if (!existsSync3(distDir)) {
@@ -491,6 +507,7 @@ async function runPackage(opts) {
   }
   return {
     ok: true,
+    command: "package",
     target,
     projectRoot: project.root,
     outputPath: result.outputPath,
@@ -536,7 +553,7 @@ function createProgram(baseLogger = console) {
   program.name("lessonkit").description("LessonKit CLI").version(version);
   program.command("init").description("Initialize a LessonKit project from the Vite + React template").argument("[name]", "Project directory name").option("--here", "Initialize in the current directory").option("--skip-install", "Skip npm install").option(
     "--force",
-    "With --here, allow init when the directory is empty or contains only dotfiles"
+    "Requires --here: allow init when the directory is empty or contains only dotfiles"
   ).option("--json", "Emit structured JSON result").action(async (name, opts) => {
     const logger = createLogger({ json: opts.json });
     await handleCommand(
@@ -557,7 +574,9 @@ function createProgram(baseLogger = console) {
       Boolean(opts.json)
     );
   });
-  addCwdAndJson(program.command("build").description("Production Vite build")).action(
+  addCwdAndJson(
+    program.command("build").description("Production Vite build").allowUnknownOption().allowExcessArguments()
+  ).action(
     async (opts, command) => {
       const logger = createLogger({ json: opts.json });
       const viteArgs = command.args;
@@ -580,13 +599,12 @@ function createProgram(baseLogger = console) {
           json: opts.json
         });
         if (!opts.json && result.ok) {
-          if (result.target === "react-vite" && "distDir" in result) {
+          if (result.command === "package" && result.target === "react-vite") {
             logger.log(`Built react-vite \u2192 ${result.distDir}`);
-          } else if ("outputPath" in result || "outputDir" in result) {
+          } else if (result.command === "package") {
             const dest = result.outputPath ?? result.outputDir;
-            const count = "fileCount" in result ? result.fileCount : void 0;
             logger.log(
-              `Packaged ${result.target}${dest ? ` \u2192 ${dest}` : ""}${count != null ? ` (${count} files)` : ""}`
+              `Packaged ${result.target}${dest ? ` \u2192 ${dest}` : ""} (${result.fileCount} files)`
             );
           }
         }

package/dist/index.js

@@ -156,6 +156,12 @@ async function runInit(opts, logger) {
       exitCode: EXIT_INVALID_PROJECT
     });
   }
+  if (opts.force && !opts.here) {
+    throw new CliError("--force requires --here (initialize in the current directory).", {
+      code: "INVALID_PROJECT",
+      exitCode: EXIT_INVALID_PROJECT
+    });
+  }
   const slug = slugifyId(rawName ?? "my-course");
   const projectName = rawName ?? slug;
   const projectDir = opts.here ? cwd : resolve(cwd, slug);
@@ -251,11 +257,8 @@ async function loadLessonkitJson(projectRoot) {
     throwManifestCliError(configPath, parsed.issues);
   }
   return {
-    root: projectRoot,
-    schemaVersion: 1,
-    name: parsed.manifest.name,
-    course: parsed.manifest.course,
-    paths: parsed.manifest.paths
+    ...parsed.manifest,
+    root: projectRoot
   };
 }
 function throwManifestCliError(configPath, issues) {
@@ -358,6 +361,18 @@ function assertNode18ForLxpack() {
 // src/lib/paths.ts
 import { resolve as resolve3 } from "path";
 import { resolveSafePackageOutputOverride } from "@lessonkit/lxpack";
+
+// src/lib/targetTypes.ts
+var PACKAGE_TARGETS = [
+  "react-vite",
+  "scorm12",
+  "scorm2004",
+  "xapi",
+  "cmi5",
+  "standalone"
+];
+
+// src/lib/paths.ts
 function resolveDistDir(project) {
   return resolve3(project.root, project.paths.spaDistDir);
 }
@@ -388,14 +403,6 @@ function resolveViteBuildArgs(project) {
   }
   return args;
 }
-var PACKAGE_TARGETS = [
-  "react-vite",
-  "scorm12",
-  "scorm2004",
-  "xapi",
-  "cmi5",
-  "standalone"
-];
 function parsePackageTarget(value) {
   if (!value) {
     throw new Error("TARGET_REQUIRED");
@@ -446,8 +453,17 @@ async function runPackage(opts) {
   }
   const project = await loadProject(opts.cwd ?? process.cwd());
   const distDir = resolveDistDir(project);
+  if (opts.noBuild && !existsSync3(distDir)) {
+    throw new CliError(
+      `dist directory not found at ${distDir}. Run lessonkit build before packaging with --no-build.`,
+      {
+        code: "INVALID_PROJECT",
+        exitCode: EXIT_INVALID_PROJECT
+      }
+    );
+  }
   if (target === "react-vite") {
-    if (!opts.noBuild || !existsSync3(distDir)) {
+    if (!opts.noBuild) {
       await runBuild({ cwd: project.root, json: opts.json });
     }
     if (!existsSync3(distDir)) {
@@ -456,10 +472,10 @@ async function runPackage(opts) {
         exitCode: EXIT_INVALID_PROJECT
       });
     }
-    return { ok: true, target, projectRoot: project.root, distDir };
+    return { ok: true, command: "package", target, projectRoot: project.root, distDir };
   }
   assertNode18ForLxpack();
-  if (!opts.noBuild || !existsSync3(distDir)) {
+  if (!opts.noBuild) {
     await runBuild({ cwd: project.root, json: opts.json });
   }
   if (!existsSync3(distDir)) {
@@ -489,6 +505,7 @@ async function runPackage(opts) {
   }
   return {
     ok: true,
+    command: "package",
     target,
     projectRoot: project.root,
     outputPath: result.outputPath,
@@ -534,7 +551,7 @@ function createProgram(baseLogger = console) {
   program.name("lessonkit").description("LessonKit CLI").version(version);
   program.command("init").description("Initialize a LessonKit project from the Vite + React template").argument("[name]", "Project directory name").option("--here", "Initialize in the current directory").option("--skip-install", "Skip npm install").option(
     "--force",
-    "With --here, allow init when the directory is empty or contains only dotfiles"
+    "Requires --here: allow init when the directory is empty or contains only dotfiles"
   ).option("--json", "Emit structured JSON result").action(async (name, opts) => {
     const logger = createLogger({ json: opts.json });
     await handleCommand(
@@ -555,7 +572,9 @@ function createProgram(baseLogger = console) {
       Boolean(opts.json)
     );
   });
-  addCwdAndJson(program.command("build").description("Production Vite build")).action(
+  addCwdAndJson(
+    program.command("build").description("Production Vite build").allowUnknownOption().allowExcessArguments()
+  ).action(
     async (opts, command) => {
       const logger = createLogger({ json: opts.json });
       const viteArgs = command.args;
@@ -578,13 +597,12 @@ function createProgram(baseLogger = console) {
           json: opts.json
         });
         if (!opts.json && result.ok) {
-          if (result.target === "react-vite" && "distDir" in result) {
+          if (result.command === "package" && result.target === "react-vite") {
             logger.log(`Built react-vite \u2192 ${result.distDir}`);
-          } else if ("outputPath" in result || "outputDir" in result) {
+          } else if (result.command === "package") {
             const dest = result.outputPath ?? result.outputDir;
-            const count = "fileCount" in result ? result.fileCount : void 0;
             logger.log(
-              `Packaged ${result.target}${dest ? ` \u2192 ${dest}` : ""}${count != null ? ` (${count} files)` : ""}`
+              `Packaged ${result.target}${dest ? ` \u2192 ${dest}` : ""} (${result.fileCount} files)`
             );
           }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessonkit/cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "private": false,
   "description": "LessonKit CLI — init, dev, build, and package learning experiences.",
   "license": "Apache-2.0",
@@ -42,8 +42,8 @@
     "lint": "echo \"(no lint configured yet)\""
   },
   "dependencies": {
-    "@lessonkit/core": "1.0.0",
-    "@lessonkit/lxpack": "1.0.0",
+    "@lessonkit/core": "1.0.1",
+    "@lessonkit/lxpack": "1.0.1",
     "commander": "^14.0.1"
   },
   "engines": {

package/template/vite-react/package.json

@@ -13,16 +13,16 @@
     "test:coverage": "vitest run --coverage --passWithNoTests=false"
   },
   "dependencies": {
-    "@lessonkit/core": "^1.0.0",
-    "@lessonkit/react": "^1.0.0",
-    "@lessonkit/themes": "^1.0.0",
-    "@lessonkit/xapi": "^1.0.0",
+    "@lessonkit/core": "^1.0.1",
+    "@lessonkit/react": "^1.0.1",
+    "@lessonkit/themes": "^1.0.1",
+    "@lessonkit/xapi": "^1.0.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"
   },
   "devDependencies": {
-    "@lessonkit/cli": "^1.0.0",
-    "@lessonkit/lxpack": "^1.0.0",
+    "@lessonkit/cli": "^1.0.1",
+    "@lessonkit/lxpack": "^1.0.1",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^18.3.23",
     "@types/react-dom": "^18.3.7",