mr-md 1.0.0 → 1.0.2

package/dist/builder.d.ts

@@ -4,7 +4,7 @@ export declare class LessonBuilder {
     private blocks;
     private options;
     private _rawOptions;
-    constructor(title: string, options?: BuildOptions);
+    constructor(title: string, options?: BuildOptions, callerDir?: string);
     /**
      * Sets the URL slug for the generated HTML file.
      * Automatically generated from the title by default.
@@ -26,7 +26,7 @@ export declare class LessonBuilder {
     /** Curated production defaults for the generated lesson shell. */
     preset(preset: NonNullable<BuildOptions["preset"]>): this;
     /** @internal Used by ChapterBuilder to push down shared config */
-    _inheritOptions(parentOpts: BuildOptions): void;
+    _inheritOptions(parentOpts: BuildOptions, parentRawOpts?: BuildOptions): void;
     /** @internal Used by ChapterBuilder */
     _setParentSlug(slug: string): void;
     /** @internal Used by ChapterBuilder */
@@ -146,7 +146,8 @@ export declare class ChapterBuilder {
     private meta;
     private lessonBuilders;
     private options;
-    constructor(title: string, options?: BuildOptions);
+    private _rawOptions;
+    constructor(title: string, options?: BuildOptions, callerDir?: string);
     slug(slug: string): this;
     description(text: string): this;
     status(status: "completed" | "active" | "locked"): this;

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,24 +1,56 @@
 import * as fs from "fs";
 import * as path from "path";
 import { render, renderChapter } from "./renderer/index.js";
+function getCallerDir() {
+    const err = new Error();
+    const stack = err.stack?.split("\n");
+    if (!stack || stack.length < 2)
+        return undefined;
+    let builderFilePath;
+    for (let i = 1; i < stack.length; i++) {
+        const line = stack[i];
+        const match = line.match(/\((.*?):\d+:\d+\)/) || line.match(/at (.*?):\d+:\d+/);
+        if (match) {
+            let p = match[1];
+            if (p.startsWith("file://")) {
+                p = p.replace(/^file:\/\//, "");
+            }
+            if (p.startsWith("/") && p[2] === ":") {
+                p = p.substring(1); // Handle Windows paths like /C:/
+            }
+            if (!builderFilePath) {
+                builderFilePath = p;
+                continue;
+            }
+            if (p === builderFilePath) {
+                continue;
+            }
+            return path.dirname(p);
+        }
+    }
+    return undefined;
+}
 // ─── LessonBuilder ────────────────────────────────────────────────────────────
 export class LessonBuilder {
     meta;
     blocks = [];
     options;
     _rawOptions;
-    constructor(title, options = {}) {
+    constructor(title, options = {}, callerDir) {
         this._rawOptions = options;
+        let slug = title
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/(^-|-$)/g, "");
+        if (!slug)
+            slug = "lesson";
         this.meta = {
             title,
-            slug: title
-                .toLowerCase()
-                .replace(/[^a-z0-9]+/g, "-")
-                .replace(/(^-|-$)/g, ""),
+            slug,
         };
         this.options = {
             outDir: options.outDir ?? "./out",
-            contentBase: options.contentBase ?? ".",
+            contentBase: options.contentBase ?? callerDir ?? ".",
             theme: options.theme ?? "auto",
             palette: options.palette ?? "ink",
             strict: options.strict ?? true,
@@ -75,11 +107,11 @@ export class LessonBuilder {
         return this;
     }
     /** @internal Used by ChapterBuilder to push down shared config */
-    _inheritOptions(parentOpts) {
+    _inheritOptions(parentOpts, parentRawOpts) {
         this.options = {
-            outDir: this._rawOptions.outDir ?? parentOpts.outDir ?? this.options.outDir,
+            outDir: this._rawOptions.outDir ?? (parentRawOpts?.outDir || parentOpts.outDir) ?? this.options.outDir,
             contentBase: this._rawOptions.contentBase ??
-                parentOpts.contentBase ??
+                parentRawOpts?.contentBase ??
                 this.options.contentBase,
             theme: this._rawOptions.theme ?? parentOpts.theme ?? this.options.theme,
             palette: this._rawOptions.palette ?? parentOpts.palette ?? this.options.palette,
@@ -359,7 +391,7 @@ export class LessonBuilder {
  * @example const l = lesson("Introduction to Kinematics").markdown("intro.md");
  */
 export function lesson(title, options = {}) {
-    return new LessonBuilder(title, options);
+    return new LessonBuilder(title, options, getCallerDir());
 }
 function normalizeSimulationOptions(opts, legacyHeight, fileConfig = null) {
     let inline;
@@ -448,17 +480,22 @@ export class ChapterBuilder {
     meta;
     lessonBuilders = [];
     options;
-    constructor(title, options = {}) {
+    _rawOptions;
+    constructor(title, options = {}, callerDir) {
+        this._rawOptions = options;
+        let slug = title
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/(^-|-$)/g, "");
+        if (!slug)
+            slug = "chapter";
         this.meta = {
             title,
-            slug: title
-                .toLowerCase()
-                .replace(/[^a-z0-9]+/g, "-")
-                .replace(/(^-|-$)/g, ""),
+            slug,
         };
         this.options = {
             outDir: options.outDir ?? "./out",
-            contentBase: options.contentBase ?? ".",
+            contentBase: options.contentBase ?? callerDir ?? ".",
             theme: options.theme ?? "auto",
             palette: options.palette ?? "ink",
             strict: options.strict ?? true,
@@ -484,7 +521,7 @@ export class ChapterBuilder {
         return this;
     }
     lesson(lessonBuilder) {
-        lessonBuilder._inheritOptions(this.options);
+        lessonBuilder._inheritOptions(this.options, this._rawOptions);
         lessonBuilder._setParentSlug(this.meta.slug);
         this.lessonBuilders.push(lessonBuilder);
         return this;
@@ -541,5 +578,5 @@ export class ChapterBuilder {
  *   .build();
  */
 export function chapter(title, options = {}) {
-    return new ChapterBuilder(title, options);
+    return new ChapterBuilder(title, options, getCallerDir());
 }

package/dist/renderer/blocks.d.ts

@@ -5,11 +5,11 @@ export declare function escHtml(str: string): string;
 export declare function escAttr(str: string): string;
 declare function renderBlock(block: Block, idx: number, options: BuildOptions): {
     html: string;
-    navItem?: NavItem;
+    navItems?: NavItem[];
 };
 declare function renderBlockInner(block: Block, idx: number, options: BuildOptions): {
     html: string;
-    navItem?: NavItem;
+    navItems?: NavItem[];
 };
 export { blockChrome, renderBlock, renderBlockInner };
 //# sourceMappingURL=blocks.d.ts.map

package/dist/renderer/blocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/renderer/blocks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAA0B,MAAM,aAAa,CAAC;AAC/E,OAAO,EACN,WAAW,EAKX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,OAAO,EAAmC,MAAM,YAAY,CAAC;AAG3E,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO3C;AACD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAID,iBAAS,WAAW,CACnB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAuBrC;AAED,iBAAS,gBAAgB,CACxB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAgQrC;AAuID,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/renderer/blocks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAA0B,MAAM,aAAa,CAAC;AAC/E,OAAO,EACN,WAAW,EAKX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,OAAO,EAAmC,MAAM,YAAY,CAAC;AAG3E,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO3C;AACD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAID,iBAAS,WAAW,CACnB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CAuBxC;AAED,iBAAS,gBAAgB,CACxB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CA0QxC;AAuID,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/renderer/blocks.js

@@ -42,13 +42,18 @@ function renderBlockInner(block, idx, options) {
             const id = `heading-${idx}`;
             return {
                 html: `<section id="${id}" class="bk-section bk-heading">${html}</section>`,
-                navItem: { id, label, kind: "heading" },
+                navItems: [{ id, label, kind: "heading" }],
             };
         }
         case "markdown": {
             const md = resolveContent(block.src, options, "md");
-            const { html } = mdToHtml(md);
-            return { html: `<div class="bk-markdown">${html}</div>` };
+            const { html, headings } = mdToHtml(md);
+            const navItems = headings.map(h => ({
+                id: h.id,
+                label: h.text,
+                kind: h.level === 2 ? "heading" : "section"
+            }));
+            return { html: `<div class="bk-markdown">${html}</div>`, navItems: navItems.length > 0 ? navItems : undefined };
         }
         case "section": {
             const md = resolveContent(block.src, options, "md");
@@ -57,7 +62,7 @@ function renderBlockInner(block, idx, options) {
             const id = `section-${idx}`;
             return {
                 html: `<section id="${id}" class="bk-section bk-subsection">${html}</section>`,
-                navItem: { id, label, kind: "section" },
+                navItems: [{ id, label, kind: "section" }],
             };
         }
         case "important":
@@ -85,8 +90,9 @@ function renderBlockInner(block, idx, options) {
         }
         case "code": {
             const raw = resolveContent(block.src, options, "text"); // Could be file or inline
+            const isInlineCode = typeof block.src === "string" && (block.src.includes("\n") || block.src.includes(" "));
             const lang = block.lang ??
-                (typeof block.src === "string" && block.src.includes(".")
+                (typeof block.src === "string" && !isInlineCode && block.src.includes(".")
                     ? (block.src.split(".").pop() ?? "")
                     : "");
             let highlighted = escHtml(raw);
@@ -106,7 +112,7 @@ function renderBlockInner(block, idx, options) {
             };
         }
         case "simulation": {
-            const propsJson = JSON.stringify(block.props ?? {});
+            const propsJson = escapeScriptJson(block.props ?? {});
             const simSrc = resolveContent(block.src, options, "js");
             const simConfig = { js: simSrc, loop: false, dependencies: block.dependencies };
             return {
@@ -200,7 +206,11 @@ function renderBlockInner(block, idx, options) {
             let quiz = { questions: [] };
             const rawJson = resolveContent(block.src, options, "json");
             try {
-                quiz = JSON.parse(rawJson);
+                const trimmed = rawJson.trim();
+                if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) {
+                    throw new Error("Quiz file not found or invalid JSON format");
+                }
+                quiz = JSON.parse(trimmed);
             }
             catch (e) {
                 const msg = e instanceof Error ? e.message : String(e);
@@ -222,11 +232,11 @@ function renderBlockInner(block, idx, options) {
             ${quiz.questions.map((q, qi) => renderQuestion(q, `quiz-${idx}`, qi)).join("\n")}
           </div>
         </div>`,
-                navItem: {
-                    id: `quiz-${idx}`,
-                    label: block.label ?? "Questions",
-                    kind: "quiz",
-                },
+                navItems: [{
+                        id: `quiz-${idx}`,
+                        label: block.label ?? "Questions",
+                        kind: "quiz",
+                    }],
             };
         }
         case "divider":

package/dist/renderer/index.js

@@ -5,10 +5,10 @@ export function render(lesson, opts = {}) {
     const bodyItems = [];
     const structuredNavItems = [];
     lesson.blocks.forEach((block, idx) => {
-        const { html, navItem } = renderBlock(block, idx, opts);
+        const { html, navItems } = renderBlock(block, idx, opts);
         bodyItems.push(html);
-        if (navItem) {
-            structuredNavItems.push(navItem);
+        if (navItems) {
+            structuredNavItems.push(...navItems);
         }
     });
     return renderPage(lesson, structuredNavItems, bodyItems.join("\n"), opts);

package/dist/renderer/markdown.d.ts

@@ -2,6 +2,11 @@ import type { Block } from "../types.js";
 declare function mdToHtml(md: string): {
     html: string;
     title: string;
+    headings: {
+        id: string;
+        text: string;
+        level: number;
+    }[];
 };
 declare function blockChrome(kind: string, label: string | undefined, caption: string | undefined, body: string, accent?: string, allowMaximize?: boolean): string;
 declare function mdInline(text: string): string;

package/dist/renderer/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/renderer/markdown.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAYzC,iBAAS,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAsE7D;AAeD,iBAAS,WAAW,CACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,SAAY,EAClB,aAAa,UAAO,GAClB,MAAM,CAYR;AAED,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBtC;AAED,iBAAS,wBAAwB,CAChC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,GAC3C,MAAM,CAiCR;AAED,iBAAS,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIhD;AAED,OAAO,EACN,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,wBAAwB,GACxB,CAAC"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/renderer/markdown.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAYzC,iBAAS,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAmFtH;AAeD,iBAAS,WAAW,CACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,SAAY,EAClB,aAAa,UAAO,GAClB,MAAM,CAYR;AAED,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBtC;AAED,iBAAS,wBAAwB,CAChC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,GAC3C,MAAM,CAiCR;AAED,iBAAS,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIhD;AAED,OAAO,EACN,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,wBAAwB,GACxB,CAAC"}

package/dist/renderer/markdown.js

@@ -41,7 +41,18 @@ function mdToHtml(md) {
     codeBlocks.forEach((match, id) => {
         processedMd = processedMd.replace(`@@BK_CODE_${id}@@`, () => match);
     });
-    let html = marked.parse(processedMd);
+    const headings = [];
+    let headingIdCounter = 0;
+    const renderer = new marked.Renderer();
+    renderer.heading = ({ tokens, depth, text }) => {
+        const id = `bk-heading-${headingIdCounter++}`;
+        if (depth === 2 || depth === 3) {
+            const plainText = text.replace(/<[^>]+>/g, "");
+            headings.push({ id, text: plainText, level: depth });
+        }
+        return `<h${depth} id="${id}" class="bk-heading-${depth}">${text}</h${depth}>`;
+    };
+    let html = marked.parse(processedMd, { renderer });
     // Restore math
     mathBlocks.forEach((tex, id) => {
         const rendered = katex.renderToString(tex, {
@@ -60,7 +71,7 @@ function mdToHtml(md) {
         });
         html = html.replace(`@@BK_MATH_INLINE_${id}@@`, () => rendered);
     });
-    return { html, title };
+    return { html, title, headings };
 }
 function escHtml(s) {
     return s

package/dist/renderer/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/renderer/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,OAAO;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;CACrC;AAID,iBAAS,cAAc,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,MAAe,GAClD,MAAM,CA4BR;AAED,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAmCnE;AAED,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/renderer/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,OAAO;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;CACrC;AAID,iBAAS,cAAc,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,MAAe,GAClD,MAAM,CAmCR;AAED,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAwCnE;AAED,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC"}

package/dist/renderer/utils.js

@@ -4,6 +4,12 @@ import * as path from "path";
 function resolveContent(src, options, expectedType = "text") {
     if (src.includes("\n"))
         return src;
+    if (/^https?:\/\//.test(src)) {
+        if (options.strict !== false) {
+            throw new Error(`Remote URLs are not yet supported for content files: ${src}`);
+        }
+        return src;
+    }
     const isLikelyFilePath = (expectedType !== "text" && src.endsWith(`.${expectedType}`)) ||
         src.startsWith("/") ||
         src.startsWith("./") ||
@@ -24,9 +30,14 @@ function resolveContent(src, options, expectedType = "text") {
     return src;
 }
 function resolveAssetSrc(src, options) {
-    if (/^(https?:|data:|\/)/.test(src))
+    if (/^(https?:|data:)/.test(src))
+        return src;
+    const isWebAbsolute = src.startsWith("/") && !fs.existsSync(src);
+    if (isWebAbsolute)
         return src;
-    const filePath = path.resolve(options.contentBase ?? ".", src);
+    const filePath = path.isAbsolute(src)
+        ? src
+        : path.resolve(options.contentBase ?? ".", src);
     if (!fs.existsSync(filePath)) {
         if (options.strict !== false)
             throw new Error(`Missing media asset: ${filePath}`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mr-md",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "Mr Markdown is an opinionated TypeScript SDK for building interactive, single-file learning pages.",
 	"type": "module",
 	"main": "dist/index.js",

package/src/builder.ts

@@ -31,6 +31,40 @@ import type {
 	YouTubeOptions,
 } from "./types.js";
 
+function getCallerDir(): string | undefined {
+	const err = new Error();
+	const stack = err.stack?.split("\n");
+	if (!stack || stack.length < 2) return undefined;
+
+	let builderFilePath: string | undefined;
+
+	for (let i = 1; i < stack.length; i++) {
+		const line = stack[i];
+		const match = line.match(/\((.*?):\d+:\d+\)/) || line.match(/at (.*?):\d+:\d+/);
+		if (match) {
+			let p = match[1];
+			if (p.startsWith("file://")) {
+				p = p.replace(/^file:\/\//, "");
+			}
+			if (p.startsWith("/") && p[2] === ":") {
+				p = p.substring(1); // Handle Windows paths like /C:/
+			}
+			
+			if (!builderFilePath) {
+				builderFilePath = p;
+				continue;
+			}
+			
+			if (p === builderFilePath) {
+				continue;
+			}
+			
+			return path.dirname(p);
+		}
+	}
+	return undefined;
+}
+
 // ─── LessonBuilder ────────────────────────────────────────────────────────────
 
 export class LessonBuilder {
@@ -39,18 +73,22 @@ export class LessonBuilder {
 	private options: BuildOptions;
 	private _rawOptions: BuildOptions;
 
-	constructor(title: string, options: BuildOptions = {}) {
+	constructor(title: string, options: BuildOptions = {}, callerDir?: string) {
 		this._rawOptions = options;
+		
+		let slug = title
+			.toLowerCase()
+			.replace(/[^a-z0-9]+/g, "-")
+			.replace(/(^-|-$)/g, "");
+		if (!slug) slug = "lesson";
+
 		this.meta = {
 			title,
-			slug: title
-				.toLowerCase()
-				.replace(/[^a-z0-9]+/g, "-")
-				.replace(/(^-|-$)/g, ""),
+			slug,
 		};
 		this.options = {
 			outDir: options.outDir ?? "./out",
-			contentBase: options.contentBase ?? ".",
+			contentBase: options.contentBase ?? callerDir ?? ".",
 			theme: options.theme ?? "auto",
 			palette: options.palette ?? "ink",
 			strict: options.strict ?? true,
@@ -115,13 +153,13 @@ export class LessonBuilder {
 	}
 
 	/** @internal Used by ChapterBuilder to push down shared config */
-	_inheritOptions(parentOpts: BuildOptions) {
+	_inheritOptions(parentOpts: BuildOptions, parentRawOpts?: BuildOptions) {
 		this.options = {
 			outDir:
-				this._rawOptions.outDir ?? parentOpts.outDir ?? this.options.outDir,
+				this._rawOptions.outDir ?? (parentRawOpts?.outDir || parentOpts.outDir) ?? this.options.outDir,
 			contentBase:
 				this._rawOptions.contentBase ??
-				parentOpts.contentBase ??
+				parentRawOpts?.contentBase ??
 				this.options.contentBase,
 			theme: this._rawOptions.theme ?? parentOpts.theme ?? this.options.theme,
 			palette:
@@ -476,7 +514,7 @@ export function lesson(
 	title: string,
 	options: BuildOptions = {},
 ): LessonBuilder {
-	return new LessonBuilder(title, options);
+	return new LessonBuilder(title, options, getCallerDir());
 }
 
 function normalizeSimulationOptions(
@@ -594,18 +632,23 @@ export class ChapterBuilder {
 	private meta: ChapterMeta;
 	private lessonBuilders: LessonBuilder[] = [];
 	private options: BuildOptions;
+	private _rawOptions: BuildOptions;
+
+	constructor(title: string, options: BuildOptions = {}, callerDir?: string) {
+		this._rawOptions = options;
+		let slug = title
+			.toLowerCase()
+			.replace(/[^a-z0-9]+/g, "-")
+			.replace(/(^-|-$)/g, "");
+		if (!slug) slug = "chapter";
 
-	constructor(title: string, options: BuildOptions = {}) {
 		this.meta = {
 			title,
-			slug: title
-				.toLowerCase()
-				.replace(/[^a-z0-9]+/g, "-")
-				.replace(/(^-|-$)/g, ""),
+			slug,
 		};
 		this.options = {
 			outDir: options.outDir ?? "./out",
-			contentBase: options.contentBase ?? ".",
+			contentBase: options.contentBase ?? callerDir ?? ".",
 			theme: options.theme ?? "auto",
 			palette: options.palette ?? "ink",
 			strict: options.strict ?? true,
@@ -635,7 +678,7 @@ export class ChapterBuilder {
 	}
 
 	lesson(lessonBuilder: LessonBuilder): this {
-		lessonBuilder._inheritOptions(this.options);
+		lessonBuilder._inheritOptions(this.options, this._rawOptions);
 		lessonBuilder._setParentSlug(this.meta.slug);
 		this.lessonBuilders.push(lessonBuilder);
 		return this;
@@ -704,5 +747,5 @@ export function chapter(
 	title: string,
 	options: BuildOptions = {},
 ): ChapterBuilder {
-	return new ChapterBuilder(title, options);
+	return new ChapterBuilder(title, options, getCallerDir());
 }

package/src/renderer/blocks.ts

@@ -29,7 +29,7 @@ function renderBlock(
 	block: Block,
 	idx: number,
 	options: BuildOptions,
-): { html: string; navItem?: NavItem } {
+): { html: string; navItems?: NavItem[] } {
 	try {
 		const result = renderBlockInner(block, idx, options);
 		if (
@@ -58,7 +58,7 @@ function renderBlockInner(
 	block: Block,
 	idx: number,
 	options: BuildOptions,
-): { html: string; navItem?: NavItem } {
+): { html: string; navItems?: NavItem[] } {
 	switch (block.type) {
 		case "heading": {
 			const md = resolveContent(block.src, options, "md");
@@ -67,14 +67,19 @@ function renderBlockInner(
 			const id = `heading-${idx}`;
 			return {
 				html: `<section id="${id}" class="bk-section bk-heading">${html}</section>`,
-				navItem: { id, label, kind: "heading" },
+				navItems: [{ id, label, kind: "heading" }],
 			};
 		}
 
 		case "markdown": {
 			const md = resolveContent(block.src, options, "md");
-			const { html } = mdToHtml(md);
-			return { html: `<div class="bk-markdown">${html}</div>` };
+			const { html, headings } = mdToHtml(md);
+			const navItems: NavItem[] = headings.map(h => ({
+				id: h.id,
+				label: h.text,
+				kind: h.level === 2 ? "heading" : "section"
+			}));
+			return { html: `<div class="bk-markdown">${html}</div>`, navItems: navItems.length > 0 ? navItems : undefined };
 		}
 
 		case "section": {
@@ -84,7 +89,7 @@ function renderBlockInner(
 			const id = `section-${idx}`;
 			return {
 				html: `<section id="${id}" class="bk-section bk-subsection">${html}</section>`,
-				navItem: { id, label, kind: "section" },
+				navItems: [{ id, label, kind: "section" }],
 			};
 		}
 
@@ -114,9 +119,10 @@ function renderBlockInner(
 
 		case "code": {
 			const raw = resolveContent(block.src, options, "text"); // Could be file or inline
+			const isInlineCode = typeof block.src === "string" && (block.src.includes("\n") || block.src.includes(" "));
 			const lang =
 				block.lang ??
-				(typeof block.src === "string" && block.src.includes(".")
+				(typeof block.src === "string" && !isInlineCode && block.src.includes(".")
 					? (block.src.split(".").pop() ?? "")
 					: "");
             let highlighted = escHtml(raw);
@@ -136,7 +142,7 @@ function renderBlockInner(
 		}
 
 		case "simulation": {
-			const propsJson = JSON.stringify(block.props ?? {});
+			const propsJson = escapeScriptJson(block.props ?? {});
 			const simSrc = resolveContent(block.src, options, "js");
 			const simConfig = { js: simSrc, loop: false, dependencies: block.dependencies };
 			return {
@@ -278,7 +284,11 @@ function renderBlockInner(
 			let quiz: QuizFile = { questions: [] };
 			const rawJson = resolveContent(block.src, options, "json");
 			try {
-				quiz = JSON.parse(rawJson);
+				const trimmed = rawJson.trim();
+				if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) {
+					throw new Error("Quiz file not found or invalid JSON format");
+				}
+				quiz = JSON.parse(trimmed);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
 				if (options.strict !== false) {
@@ -300,11 +310,11 @@ function renderBlockInner(
             ${quiz.questions.map((q, qi) => renderQuestion(q, `quiz-${idx}`, qi)).join("\n")}
           </div>
         </div>`,
-				navItem: {
+				navItems: [{
 					id: `quiz-${idx}`,
 					label: block.label ?? "Questions",
 					kind: "quiz",
-				},
+				}],
 			};
 		}
 

package/src/renderer/index.ts

@@ -10,10 +10,10 @@ export function render(lesson: Lesson, opts: BuildOptions = {}): string {
 	const structuredNavItems: NavItem[] = [];
 
 	lesson.blocks.forEach((block, idx) => {
-		const { html, navItem } = renderBlock(block, idx, opts);
+		const { html, navItems } = renderBlock(block, idx, opts);
 		bodyItems.push(html);
-		if (navItem) {
-			structuredNavItems.push(navItem);
+		if (navItems) {
+			structuredNavItems.push(...navItems);
 		}
 	});
 

package/src/renderer/markdown.ts

@@ -14,7 +14,7 @@ marked.use(markedHighlight({
 
 // ─── Markdown Rendering (using Marked + KaTeX) ───────────────────────────────
 
-function mdToHtml(md: string): { html: string; title: string } {
+function mdToHtml(md: string): { html: string; title: string; headings: { id: string; text: string; level: number }[] } {
 	let title = "";
 
 	// Extract first H1 or H2 as title
@@ -55,7 +55,20 @@ function mdToHtml(md: string): { html: string; title: string } {
 		processedMd = processedMd.replace(`@@BK_CODE_${id}@@`, () => match);
 	});
 
-	let html = marked.parse(processedMd) as string;
+	const headings: { id: string; text: string; level: number }[] = [];
+	let headingIdCounter = 0;
+
+	const renderer = new marked.Renderer();
+	renderer.heading = ({ tokens, depth, text }) => {
+		const id = `bk-heading-${headingIdCounter++}`;
+		if (depth === 2 || depth === 3) {
+			const plainText = text.replace(/<[^>]+>/g, "");
+			headings.push({ id, text: plainText, level: depth });
+		}
+		return `<h${depth} id="${id}" class="bk-heading-${depth}">${text}</h${depth}>`;
+	};
+
+	let html = marked.parse(processedMd, { renderer }) as string;
 
 	// Restore math
 	mathBlocks.forEach((tex, id) => {
@@ -83,7 +96,7 @@ function mdToHtml(md: string): { html: string; title: string } {
 		html = html.replace(`@@BK_MATH_INLINE_${id}@@`, () => rendered);
 	});
 
-	return { html, title };
+	return { html, title, headings };
 }
 
 function escHtml(s: string): string {

package/src/renderer/utils.ts

@@ -17,6 +17,13 @@ function resolveContent(
 ): string {
 	if (src.includes("\n")) return src;
 
+	if (/^https?:\/\//.test(src)) {
+		if (options.strict !== false) {
+			throw new Error(`Remote URLs are not yet supported for content files: ${src}`);
+		}
+		return src;
+	}
+
 	const isLikelyFilePath =
 		(expectedType !== "text" && src.endsWith(`.${expectedType}`)) ||
 		src.startsWith("/") ||
@@ -45,9 +52,14 @@ function resolveContent(
 }
 
 function resolveAssetSrc(src: string, options: BuildOptions): string {
-	if (/^(https?:|data:|\/)/.test(src)) return src;
+	if (/^(https?:|data:)/.test(src)) return src;
+
+	const isWebAbsolute = src.startsWith("/") && !fs.existsSync(src);
+	if (isWebAbsolute) return src;
 
-	const filePath = path.resolve(options.contentBase ?? ".", src);
+	const filePath = path.isAbsolute(src) 
+		? src 
+		: path.resolve(options.contentBase ?? ".", src);
 	if (!fs.existsSync(filePath)) {
 		if (options.strict !== false)
 			throw new Error(`Missing media asset: ${filePath}`);