mr-md 1.0.4 → 2.0.0-beta

package/README.md

@@ -13,12 +13,17 @@ The documentation has been split into dedicated guides. Start with the Quick Sta
 5. [Quizzes](./docs/quizzes.md) - Learn the JSON format for injecting interactive quizzes.
 6. [Production Checks](./docs/production-checks.md) - Understand Mr Markdown's strict mode and quality enforcement.
 
-## Example
+## Quick Start (CLI)
 
-To see a full example in action, compile the included `charge.lesson.ts`:
+The easiest way to use Mr Markdown is via the CLI which provides a smart scaffold and dev server.
 
 ```bash
-npx ts-node example/charge.lesson.ts
-# or 
-bun example/charge.lesson.ts
+mkdir my-course && cd my-course
+bunx mr-md init
+bunx mr-md g ch physics
+cd chapters/01-physics
+bunx mr-md g lesson intro
+
+# Start the dev server
+bunx mr-md dev .
 ```

package/dist/builder.d.ts

@@ -44,9 +44,9 @@ export declare class LessonBuilder {
     add(src: `${string}.mp4` | `${string}.webm` | `${string}.mov`, opts?: Omit<MediaOptions, "kind">): this;
     add(src: `${string}.mp3` | `${string}.wav` | `${string}.ogg` | `${string}.m4a`, opts?: Omit<MediaOptions, "kind">): this;
     add(src: `${string}.png` | `${string}.jpg` | `${string}.jpeg` | `${string}.gif` | `${string}.svg` | `${string}.webp` | `${string}.avif`, opts?: Omit<MediaOptions, "kind">): this;
-    add(src: string, opts?: any): this;
+    add(src: string, opts?: unknown): this;
     /**
-     * Creates a major chapter heading (H2) and a top-level sidebar navigation entry.
+     * Creates a major chapter heading (H1) and a top-level sidebar navigation entry.
      * @param src Path to a markdown file or raw markdown string.
      * @param title Optional title override for the sidebar and heading.
      * @example lesson.heading("# Welcome to Physics")
@@ -64,10 +64,10 @@ export declare class LessonBuilder {
      */
     content(src: string): this;
     /**
-     * Creates a new subsection heading (H3) and a sub-entry in the sidebar.
+     * Creates a new subsection heading (H2) and a sub-entry in the sidebar.
      * @param src Path to a markdown file or raw markdown string.
      * @param label Optional title override for the sidebar label.
-     * @example lesson.section("### 1. Kinematics")
+     * @example lesson.section("## 1. Kinematics")
      */
     section(src: string, label?: string): this;
     /**
@@ -141,7 +141,7 @@ export declare class LessonBuilder {
  * @param options Build configuration for this specific lesson.
  * @example const l = lesson("Introduction to Kinematics").markdown("intro.md");
  */
-export declare function lesson(title: string, options?: BuildOptions): LessonBuilder;
+export declare function lesson(title: string, optionsOrSetup?: BuildOptions | ((ctx: LessonBuilder) => void), setup?: (ctx: LessonBuilder) => void): LessonBuilder;
 export declare class ChapterBuilder {
     private meta;
     private lessonBuilders;
@@ -149,8 +149,6 @@ export declare class ChapterBuilder {
     private _rawOptions;
     constructor(title: string, options?: BuildOptions, callerDir?: string);
     slug(slug: string): this;
-    /** @internal Used by CourseBuilder to push down shared config */
-    _inheritOptions(parentOpts: BuildOptions, parentRawOpts?: BuildOptions): void;
     description(text: string): this;
     status(status: "completed" | "active" | "locked"): this;
     lesson(lessonBuilder: LessonBuilder): this;
@@ -168,17 +166,5 @@ export declare class ChapterBuilder {
  *   .lesson(dynamicsLesson)
  *   .build();
  */
-export declare function chapter(title: string, options?: BuildOptions): ChapterBuilder;
-export declare class CourseBuilder {
-    private meta;
-    private chapterBuilders;
-    private options;
-    private _rawOptions;
-    constructor(title: string, options?: BuildOptions, callerDir?: string);
-    slug(slug: string): this;
-    description(text: string): this;
-    chapter(chapterBuilder: ChapterBuilder): this;
-    build(): string;
-}
-export declare function course(title: string, options?: BuildOptions): CourseBuilder;
+export declare function chapter(title: string, optionsOrSetup?: BuildOptions | ((ctx: ChapterBuilder) => void), setup?: (ctx: ChapterBuilder) => void): ChapterBuilder;
 //# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}

package/dist/builder.js

@@ -1,6 +1,6 @@
 import * as fs from "fs";
 import * as path from "path";
-import { render, renderChapter, renderCourse } from "./renderer/index.js";
+import { render, renderChapter } from "./renderer/index.js";
 function getCallerDir() {
     const err = new Error();
     const stack = err.stack?.split("\n");
@@ -49,11 +49,11 @@ export class LessonBuilder {
             slug,
         };
         this.options = {
-            outDir: options.outDir ?? "./out",
+            outDir: options.outDir ?? (callerDir ? path.join(callerDir, "out") : "./out"),
             contentBase: options.contentBase ?? callerDir ?? ".",
             theme: options.theme ?? "auto",
             palette: options.palette ?? "ink",
-            strict: options.strict ?? true,
+            strict: options.strict ?? process.env.NODE_ENV !== "development",
             preset: {
                 layout: "lesson",
                 density: "comfortable",
@@ -109,16 +109,17 @@ export class LessonBuilder {
     /** @internal Used by ChapterBuilder to push down shared config */
     _inheritOptions(parentOpts, parentRawOpts) {
         this.options = {
-            ...this.options,
-            outDir: this._rawOptions.outDir ?? parentOpts.outDir ?? this.options.outDir,
-            contentBase: this._rawOptions.contentBase ?? this.options.contentBase,
+            outDir: this._rawOptions.outDir ?? (parentRawOpts?.outDir || parentOpts.outDir) ?? this.options.outDir,
+            contentBase: this._rawOptions.contentBase ??
+                parentRawOpts?.contentBase ??
+                this.options.contentBase,
             theme: this._rawOptions.theme ?? parentOpts.theme ?? this.options.theme,
             palette: this._rawOptions.palette ?? parentOpts.palette ?? this.options.palette,
             strict: this._rawOptions.strict ?? parentOpts.strict ?? this.options.strict,
             preset: {
-                ...this.options.preset,
                 ...parentOpts.preset,
                 ...this._rawOptions.preset,
+                ...this.options.preset,
             },
         };
     }
@@ -140,7 +141,6 @@ export class LessonBuilder {
     _getMeta() {
         return this.meta;
     }
-    // biome-ignore lint/suspicious/noExplicitAny: Overload implementation
     add(src, opts = {}) {
         const lower = src.toLowerCase();
         if (lower.endsWith(".md") || lower.endsWith(".mdx"))
@@ -164,7 +164,7 @@ export class LessonBuilder {
         return this.markdown(src);
     }
     /**
-     * Creates a major chapter heading (H2) and a top-level sidebar navigation entry.
+     * Creates a major chapter heading (H1) and a top-level sidebar navigation entry.
      * @param src Path to a markdown file or raw markdown string.
      * @param title Optional title override for the sidebar and heading.
      * @example lesson.heading("# Welcome to Physics")
@@ -190,10 +190,10 @@ export class LessonBuilder {
         return this.markdown(src);
     }
     /**
-     * Creates a new subsection heading (H3) and a sub-entry in the sidebar.
+     * Creates a new subsection heading (H2) and a sub-entry in the sidebar.
      * @param src Path to a markdown file or raw markdown string.
      * @param label Optional title override for the sidebar label.
-     * @example lesson.section("### 1. Kinematics")
+     * @example lesson.section("## 1. Kinematics")
      */
     section(src, label) {
         this.blocks.push({ type: "section", src, label });
@@ -389,8 +389,20 @@ export class LessonBuilder {
  * @param options Build configuration for this specific lesson.
  * @example const l = lesson("Introduction to Kinematics").markdown("intro.md");
  */
-export function lesson(title, options = {}) {
-    return new LessonBuilder(title, options, getCallerDir());
+export function lesson(title, optionsOrSetup, setup) {
+    let options = {};
+    let cb = setup;
+    if (typeof optionsOrSetup === "function") {
+        cb = optionsOrSetup;
+    }
+    else if (optionsOrSetup) {
+        options = optionsOrSetup;
+    }
+    const builder = new LessonBuilder(title, options, getCallerDir());
+    if (cb) {
+        cb(builder);
+    }
+    return builder;
 }
 function normalizeSimulationOptions(opts, legacyHeight, fileConfig = null) {
     let inline;
@@ -493,11 +505,11 @@ export class ChapterBuilder {
             slug,
         };
         this.options = {
-            outDir: options.outDir ?? "./out",
+            outDir: options.outDir ?? (callerDir ? path.join(callerDir, "out") : "./out"),
             contentBase: options.contentBase ?? callerDir ?? ".",
             theme: options.theme ?? "auto",
             palette: options.palette ?? "ink",
-            strict: options.strict ?? true,
+            strict: options.strict ?? process.env.NODE_ENV !== "development",
             preset: {
                 layout: "lesson",
                 density: "comfortable",
@@ -511,25 +523,6 @@ export class ChapterBuilder {
         this.meta.slug = slug;
         return this;
     }
-    /** @internal Used by CourseBuilder to push down shared config */
-    _inheritOptions(parentOpts, parentRawOpts) {
-        this.options = {
-            ...this.options,
-            outDir: this._rawOptions.outDir ?? parentOpts.outDir ?? this.options.outDir,
-            contentBase: this._rawOptions.contentBase ?? this.options.contentBase,
-            theme: this._rawOptions.theme ?? parentOpts.theme ?? this.options.theme,
-            palette: this._rawOptions.palette ?? parentOpts.palette ?? this.options.palette,
-            strict: this._rawOptions.strict ?? parentOpts.strict ?? this.options.strict,
-            preset: {
-                ...this.options.preset,
-                ...parentOpts.preset,
-                ...this._rawOptions.preset,
-            },
-        };
-        for (const lb of this.lessonBuilders) {
-            lb._inheritOptions(this.options, this._rawOptions);
-        }
-    }
     description(text) {
         this.meta.description = text;
         return this;
@@ -595,70 +588,18 @@ export class ChapterBuilder {
  *   .lesson(dynamicsLesson)
  *   .build();
  */
-export function chapter(title, options = {}) {
-    return new ChapterBuilder(title, options, getCallerDir());
-}
-// ─── CourseBuilder ──────────────────────────────────────────────────────────
-export class CourseBuilder {
-    meta;
-    chapterBuilders = [];
-    options;
-    _rawOptions;
-    constructor(title, options = {}, callerDir) {
-        this._rawOptions = options;
-        let slug = title
-            .toLowerCase()
-            .replace(/[^a-z0-9]+/g, "-")
-            .replace(/(^-|-$)/g, "");
-        if (!slug)
-            slug = "course";
-        this.meta = { title, slug };
-        this.options = {
-            outDir: options.outDir ?? "./out",
-            contentBase: options.contentBase ?? callerDir ?? ".",
-            theme: options.theme ?? "auto",
-            palette: options.palette ?? "ink",
-            strict: options.strict ?? true,
-            preset: {
-                layout: "lesson",
-                density: "comfortable",
-                tone: "scholarly",
-                ...options.preset,
-            },
-            ...options,
-        };
-    }
-    slug(slug) {
-        this.meta.slug = slug;
-        return this;
+export function chapter(title, optionsOrSetup, setup) {
+    let options = {};
+    let cb = setup;
+    if (typeof optionsOrSetup === "function") {
+        cb = optionsOrSetup;
     }
-    description(text) {
-        this.meta.description = text;
-        return this;
+    else if (optionsOrSetup) {
+        options = optionsOrSetup;
     }
-    chapter(chapterBuilder) {
-        chapterBuilder._inheritOptions(this.options, this._rawOptions);
-        this.chapterBuilders.push(chapterBuilder);
-        return this;
+    const builder = new ChapterBuilder(title, options, getCallerDir());
+    if (cb) {
+        cb(builder);
     }
-    build() {
-        const chapters = [];
-        for (const cb of this.chapterBuilders) {
-            cb.build();
-            chapters.push(cb.toJSON());
-        }
-        const courseData = { meta: this.meta, chapters };
-        const html = renderCourse(courseData, this.options);
-        const outDir = path.resolve(this.options.outDir);
-        if (!fs.existsSync(outDir))
-            fs.mkdirSync(outDir, { recursive: true });
-        const outPath = path.join(outDir, `${this.meta.slug}.html`);
-        fs.writeFileSync(outPath, html, "utf-8");
-        const relPath = path.relative(process.cwd(), outPath);
-        console.log(`  ✓ Built course (${this.chapterBuilders.length} chapters) → ${relPath}`);
-        return outPath;
-    }
-}
-export function course(title, options = {}) {
-    return new CourseBuilder(title, options, getCallerDir());
+    return builder;
 }

package/dist/cli/dev.d.ts

@@ -0,0 +1,2 @@
+export declare function runDev(args: string[]): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/cli/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAMA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,iBA+F1C"}

package/dist/cli/dev.js

@@ -0,0 +1,92 @@
+import * as fs from "fs";
+import * as path from "path";
+import { exec } from "child_process";
+export async function runDev(args) {
+    const dir = args[0] || ".";
+    const outDir = path.resolve(process.cwd(), dir, "out");
+    console.log(`Starting dev server for directory: ${dir}`);
+    let server;
+    const rebuild = () => {
+        console.log("Rebuilding...");
+        const entryPoints = ["chapter.ts", "index.ts", "lesson.ts"];
+        for (const entry of entryPoints) {
+            const entryPath = path.join(dir, entry);
+            if (fs.existsSync(entryPath)) {
+                exec(`NODE_ENV=development bun ${entryPath}`, (err, stdout, stderr) => {
+                    if (err)
+                        console.error("Build failed:", stderr);
+                    else {
+                        console.log("Build successful.");
+                        server?.publish("livereload", "reload");
+                    }
+                });
+                return;
+            }
+        }
+        console.log("No chapter.ts or lesson.ts found to build automatically.");
+    };
+    rebuild();
+    if (fs.existsSync(dir)) {
+        let timeout;
+        fs.watch(dir, { recursive: true }, (eventType, filename) => {
+            if (!filename || filename.includes("out/") || filename.includes(".git/"))
+                return;
+            clearTimeout(timeout);
+            timeout = setTimeout(() => {
+                console.log(`File changed: ${filename}`);
+                rebuild();
+            }, 200);
+        });
+        console.log(`Watching ${dir} for changes...`);
+    }
+    server = Bun.serve({
+        port: 3000,
+        async fetch(req, srv) {
+            if (srv.upgrade(req))
+                return;
+            const url = new URL(req.url);
+            let filePath = path.join(outDir, url.pathname);
+            if (filePath.endsWith("/")) {
+                const files = fs.existsSync(outDir) ? fs.readdirSync(outDir) : [];
+                const htmlFiles = files.filter(f => f.endsWith(".html"));
+                if (htmlFiles.includes("index.html")) {
+                    filePath = path.join(outDir, "index.html");
+                }
+                else {
+                    const chapterFile = htmlFiles.find(f => f.includes("chapter"));
+                    if (chapterFile) {
+                        filePath = path.join(outDir, chapterFile);
+                    }
+                    else if (htmlFiles.length > 0) {
+                        filePath = path.join(outDir, htmlFiles[0]);
+                    }
+                    else {
+                        filePath += "index.html";
+                    }
+                }
+            }
+            if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+                if (filePath.endsWith(".html")) {
+                    const file = Bun.file(filePath);
+                    let text = await file.text();
+                    text = text.replace("</body>", `<script>
+						const ws = new WebSocket("ws://localhost:3000/");
+						ws.onmessage = (e) => { if (e.data === "reload") location.reload(); };
+					</script></body>`);
+                    return new Response(text, { headers: { "Content-Type": "text/html" } });
+                }
+                return new Response(Bun.file(filePath));
+            }
+            const srcPath = path.join(process.cwd(), dir, url.pathname);
+            if (fs.existsSync(srcPath) && fs.statSync(srcPath).isFile()) {
+                return new Response(Bun.file(srcPath));
+            }
+            return new Response("Not found", { status: 404 });
+        },
+        websocket: {
+            message() { },
+            open(ws) { ws.subscribe("livereload"); }
+        }
+    });
+    console.log(`Dev server listening on http://localhost:3000`);
+}

package/dist/cli/generate.d.ts

@@ -0,0 +1,2 @@
+export declare function runGenerate(args: string[]): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/cli/generate.ts"],"names":[],"mappings":"AAyBA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,iBAqK/C"}

package/dist/cli/generate.js

@@ -0,0 +1,171 @@
+import * as fs from "fs";
+import * as path from "path";
+function getNextPrefix(dirPath) {
+    if (!fs.existsSync(dirPath))
+        return "01";
+    const files = fs.readdirSync(dirPath, { withFileTypes: true });
+    let maxPrefix = 0;
+    for (const file of files) {
+        if (file.isDirectory()) {
+            const match = file.name.match(/^(\d+)-/);
+            if (match) {
+                const num = parseInt(match[1], 10);
+                if (num > maxPrefix) {
+                    maxPrefix = num;
+                }
+            }
+        }
+    }
+    const next = maxPrefix + 1;
+    return next.toString().padStart(2, "0");
+}
+export async function runGenerate(args) {
+    const type = args[0];
+    const rawName = args[1];
+    if (!type || !rawName) {
+        console.error("Usage: md g <ch|le|qu|chapter|lesson|quiz> <name>");
+        process.exit(1);
+    }
+    const name = rawName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+    const cwd = process.cwd();
+    switch (type) {
+        case "ch":
+        case "chapter": {
+            const chaptersDir = path.join(cwd, "chapters");
+            if (!fs.existsSync(chaptersDir))
+                fs.mkdirSync(chaptersDir, { recursive: true });
+            const prefix = getNextPrefix(chaptersDir);
+            const chapterDirName = `${prefix}-${name}`;
+            const chapterPath = path.join(chaptersDir, chapterDirName);
+            fs.mkdirSync(chapterPath, { recursive: true });
+            fs.mkdirSync(path.join(chapterPath, "lessons"), { recursive: true });
+            const varName = name.replace(/-([a-z0-9])/g, g => g[1].toUpperCase());
+            const chapterTitle = rawName.replace(/-/g, " ").replace(/\b\w/g, l => l.toUpperCase());
+            const content = `import { chapter } from "mr-md";
+
+export const ${varName}Chapter = chapter("${chapterTitle}", ctx => {
+	// Add lessons here
+});
+
+if (import.meta.main) {
+	${varName}Chapter.build();
+}
+`;
+            fs.writeFileSync(path.join(chapterPath, "chapter.ts"), content, "utf-8");
+            console.log(`Generated Chapter: chapters/${chapterDirName}`);
+            break;
+        }
+        case "le":
+        case "lesson": {
+            // Assume we are in a chapter directory
+            const lessonsDir = path.join(cwd, "lessons");
+            if (!fs.existsSync(lessonsDir))
+                fs.mkdirSync(lessonsDir, { recursive: true });
+            const prefix = getNextPrefix(lessonsDir);
+            const lessonDirName = `${prefix}-${name}`;
+            const lessonPath = path.join(lessonsDir, lessonDirName);
+            fs.mkdirSync(lessonPath, { recursive: true });
+            fs.mkdirSync(path.join(lessonPath, "sims"), { recursive: true });
+            fs.mkdirSync(path.join(lessonPath, "media"), { recursive: true });
+            fs.mkdirSync(path.join(lessonPath, "quizzes"), { recursive: true });
+            fs.mkdirSync(path.join(lessonPath, "content"), { recursive: true });
+            const lessonTitle = rawName.replace(/-/g, " ").replace(/\b\w/g, l => l.toUpperCase());
+            const varName = name.replace(/-([a-z0-9])/g, g => g[1].toUpperCase());
+            const content = `import { lesson } from "mr-md";
+
+export const ${varName}Lesson = lesson("${lessonTitle}", { contentBase: import.meta.dir }, ctx => {
+});
+`;
+            fs.writeFileSync(path.join(lessonPath, "lesson.ts"), content, "utf-8");
+            console.log(`Generated Lesson: lessons/${lessonDirName}`);
+            // Auto import into chapter.ts
+            const chapterFile = path.join(cwd, "chapter.ts");
+            if (fs.existsSync(chapterFile)) {
+                const { Project, SyntaxKind } = await import("ts-morph");
+                const project = new Project();
+                const sourceFile = project.addSourceFileAtPath(chapterFile);
+                // 1. Add the import
+                sourceFile.addImportDeclaration({
+                    namedImports: [`${varName}Lesson`],
+                    moduleSpecifier: `./lessons/${lessonDirName}/lesson.js`
+                });
+                // 2. Find the chapter(...) call and inject ctx.lesson()
+                const calls = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression);
+                const chapterCall = calls.find((c) => c.getExpression().getText() === "chapter");
+                if (chapterCall) {
+                    const args = chapterCall.getArguments();
+                    const callback = args.find((a) => a.getKind() === SyntaxKind.ArrowFunction || a.getKind() === SyntaxKind.FunctionExpression);
+                    if (callback) {
+                        const arrow = callback.asKind(SyntaxKind.ArrowFunction);
+                        const func = callback.asKind(SyntaxKind.FunctionExpression);
+                        const body = arrow ? arrow.getBody() : func ? func.getBody() : null;
+                        if (body && body.getKind() === SyntaxKind.Block) {
+                            body.asKind(SyntaxKind.Block)?.addStatements(`ctx.lesson(${varName}Lesson);`);
+                        }
+                        else {
+                            console.warn("  ⚠ Could not auto-import: chapter callback must use { } block syntax.");
+                        }
+                    }
+                    else {
+                        console.warn("  ⚠ Could not auto-import: could not find chapter callback.");
+                    }
+                }
+                sourceFile.saveSync();
+                console.log(`Auto-imported ${varName}Lesson into chapter.ts`);
+            }
+            break;
+        }
+        case "qu":
+        case "quiz": {
+            // Assume we are in a lesson directory
+            const quizzesDir = path.join(cwd, "quizzes");
+            if (!fs.existsSync(quizzesDir))
+                fs.mkdirSync(quizzesDir, { recursive: true });
+            const quizPath = path.join(quizzesDir, `${name}.json`);
+            const content = `{
+	"questions": [
+		{
+			"q": "Sample question?",
+			"options": ["A", "B"],
+			"answer": 0
+		}
+	]
+}
+`;
+            fs.writeFileSync(quizPath, content, "utf-8");
+            console.log(`Generated Quiz: quizzes/${name}.json`);
+            // Auto import into lesson.ts
+            const lessonFile = path.join(cwd, "lesson.ts");
+            if (fs.existsSync(lessonFile)) {
+                const { Project, SyntaxKind } = await import("ts-morph");
+                const project = new Project();
+                const sourceFile = project.addSourceFileAtPath(lessonFile);
+                const calls = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression);
+                const lessonCall = calls.find((c) => c.getExpression().getText() === "lesson");
+                if (lessonCall) {
+                    const args = lessonCall.getArguments();
+                    const callback = args.find((a) => a.getKind() === SyntaxKind.ArrowFunction || a.getKind() === SyntaxKind.FunctionExpression);
+                    if (callback) {
+                        const arrow = callback.asKind(SyntaxKind.ArrowFunction);
+                        const func = callback.asKind(SyntaxKind.FunctionExpression);
+                        const body = arrow ? arrow.getBody() : func ? func.getBody() : null;
+                        if (body && body.getKind() === SyntaxKind.Block) {
+                            body.asKind(SyntaxKind.Block)?.addStatements(`ctx.quiz("quizzes/${name}.json");`);
+                        }
+                        else {
+                            console.warn("  ⚠ Could not auto-import quiz: lesson callback must use { } block syntax.");
+                        }
+                    }
+                    else {
+                        console.warn("  ⚠ Could not auto-import quiz: could not find lesson callback.");
+                    }
+                }
+                sourceFile.saveSync();
+                console.log(`Auto-added quiz to lesson.ts`);
+            }
+            break;
+        }
+        default:
+            console.error(`Unknown generator type: ${type}`);
+    }
+}

package/dist/cli/init.d.ts

@@ -0,0 +1,2 @@
+export declare function runInit(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAGA,wBAAsB,OAAO,kBA6F5B"}