mr-md 2.0.0-beta → 2.1.1-beta

package/README.md

@@ -1,6 +1,6 @@
 # Mr Markdown
 
-Mr Markdown is an opinionated TypeScript SDK for building interactive, single-file learning pages. It is designed for lessons that mix prose, LaTeX, simulations, media, video, and quizzes without making every author build layout and interaction chrome from scratch.
+Mr Markdown is an opinionated TypeScript SDK for building interactive learning pages. It is designed for lessons that mix prose, LaTeX, simulations, media, video, and quizzes without making every author build layout and interaction chrome from scratch.
 
 ## Documentation
 

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":"AAGA,OAAO,KAAK,EAEX,gBAAgB,EAEhB,YAAY,EACZ,YAAY,EACZ,OAAO,EAGP,UAAU,EAEV,cAAc,EAId,YAAY,EACZ,MAAM,EACN,UAAU,EAGV,YAAY,EACZ,SAAS,EAIT,iBAAiB,EAEjB,cAAc,EACd,MAAM,YAAY,CAAC;AA8FpB,qBAAa,aAAa;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,WAAW,CAAe;gBAEtB,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,EAAE,SAAS,CAAC,EAAE,MAAM;IAkBzE;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B,2CAA2C;IAC3C,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAK7B,4CAA4C;IAC5C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI;IAKlD,kEAAkE;IAClE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI;IASzD,kEAAkE;IAClE,eAAe,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,YAAY;IAqBtE,uCAAuC;IACvC,cAAc,CAAC,IAAI,EAAE,MAAM;IAI3B,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAKpC,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAKpC,uCAAuC;IACvC,QAAQ,IAAI,UAAU;IAMtB;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,KAAK,GAAG,GAAG,MAAM,MAAM,GAAG,IAAI;IAChD,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC,GAAG,IAAI;IAC7E,GAAG,CACF,GAAG,EAAE,GAAG,MAAM,MAAM,GAAG,GAAG,MAAM,OAAO,GAAG,GAAG,MAAM,MAAM,EACzD,IAAI,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAC/B,IAAI;IACP,GAAG,CACF,GAAG,EAAE,GAAG,MAAM,MAAM,GAAG,GAAG,MAAM,MAAM,GAAG,GAAG,MAAM,MAAM,GAAG,GAAG,MAAM,MAAM,EAC1E,IAAI,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAC/B,IAAI;IACP,GAAG,CACF,GAAG,EACA,GAAG,MAAM,MAAM,GACf,GAAG,MAAM,MAAM,GACf,GAAG,MAAM,OAAO,GAChB,GAAG,MAAM,MAAM,GACf,GAAG,MAAM,MAAM,GACf,GAAG,MAAM,OAAO,GAChB,GAAG,MAAM,OAAO,EACnB,IAAI,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAC/B,IAAI;IACP,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IA0BtC;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1C;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK3B;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1C;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK5B;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKtB;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKvB,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAKtD;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI;IAWjD,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,GAAE,cAAmB,GAAG,IAAI;IAO/D,OAAO,CAAC,oBAAoB;IAe5B;;;;;;OAMG;IACH,UAAU,CACT,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACtD,MAAM,SAAM,GACV,IAAI;IAYP;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,IAAI;IAIpD,+BAA+B;IAC/B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,IAAI;IAazD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI;IAejD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAM,GAAG,IAAI;IAI/D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAM,GAAG,IAAI;IAI/D,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,IAAI;IAWzD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAM,GAAG,IAAI;IAI/D;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAM,GAAG,IAAI;IAKxE,uBAAuB;IACvB,OAAO,IAAI,IAAI;IAOf,6EAA6E;IAC7E,MAAM,IAAI,MAAM;IAKhB,mEAAmE;IACnE,KAAK,IAAI,MAAM;CAqBf;AAID;;;;;GAKG;AACH,wBAAgB,MAAM,CACrB,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC,EAC9D,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAClC,aAAa,CAef;AAiHD,qBAAa,cAAc;IAC1B,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,WAAW,CAAe;gBAEtB,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,EAAE,SAAS,CAAC,EAAE,MAAM;IAezE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI;IAKvD,MAAM,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAO1C,KAAK,IAAI,MAAM;IA6Cf,qCAAqC;IACrC,MAAM,IAAI,OAAO;CAOjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACtB,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC,EAC/D,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GACnC,cAAc,CAehB"}

package/dist/builder.js

@@ -1,6 +1,9 @@
 import * as fs from "fs";
 import * as path from "path";
 import { render, renderChapter } from "./renderer/index.js";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 function getCallerDir() {
     const err = new Error();
     const stack = err.stack?.split("\n");
@@ -16,7 +19,7 @@ function getCallerDir() {
                 p = p.replace(/^file:\/\//, "");
             }
             if (p.startsWith("/") && p[2] === ":") {
-                p = p.substring(1); // Handle Windows paths like /C:/
+                p = p.substring(1);
             }
             if (!builderFilePath) {
                 builderFilePath = p;
@@ -30,6 +33,60 @@ function getCallerDir() {
     }
     return undefined;
 }
+function copyAssets(outDir) {
+    const assetsDir = path.join(outDir, "assets");
+    if (!fs.existsSync(assetsDir))
+        fs.mkdirSync(assetsDir, { recursive: true });
+    const srcStylesDir = path.join(__dirname, "styles");
+    const srcClientDir = path.join(__dirname, "client");
+    const fallbackStylesDir = path.join(__dirname, "../src/styles");
+    const fallbackClientDir = path.join(__dirname, "../src/client");
+    const copyDir = (src, dest) => {
+        if (!fs.existsSync(src))
+            return;
+        if (!fs.existsSync(dest))
+            fs.mkdirSync(dest, { recursive: true });
+        for (const file of fs.readdirSync(src)) {
+            const srcFile = path.join(src, file);
+            const destFile = path.join(dest, file);
+            if (fs.statSync(srcFile).isDirectory()) {
+                copyDir(srcFile, destFile);
+            }
+            else {
+                fs.copyFileSync(srcFile, destFile);
+            }
+        }
+    };
+    if (fs.existsSync(srcStylesDir))
+        copyDir(srcStylesDir, assetsDir);
+    else
+        copyDir(fallbackStylesDir, assetsDir);
+    if (fs.existsSync(srcClientDir))
+        copyDir(srcClientDir, assetsDir);
+    else
+        copyDir(fallbackClientDir, assetsDir);
+}
+function mergeOptions(options, callerDir) {
+    const merged = {
+        outDir: options.outDir ?? (callerDir ? path.join(callerDir, "out") : path.join(process.cwd(), "out")),
+        contentBase: options.contentBase ?? callerDir ?? process.cwd(),
+        theme: options.theme ?? "auto",
+        palette: options.palette ?? "ink",
+        strict: options.strict ?? process.env.NODE_ENV !== "development",
+        standalone: options.standalone ?? true,
+    };
+    for (const [k, v] of Object.entries(options)) {
+        if (v !== undefined && k !== "preset") {
+            merged[k] = v;
+        }
+    }
+    merged.preset = {
+        layout: options.preset?.layout ?? "lesson",
+        density: options.preset?.density ?? "comfortable",
+        tone: options.preset?.tone ?? "scholarly",
+    };
+    return merged;
+}
 // ─── LessonBuilder ────────────────────────────────────────────────────────────
 export class LessonBuilder {
     meta;
@@ -48,20 +105,7 @@ export class LessonBuilder {
             title,
             slug,
         };
-        this.options = {
-            outDir: options.outDir ?? (callerDir ? path.join(callerDir, "out") : "./out"),
-            contentBase: options.contentBase ?? callerDir ?? ".",
-            theme: options.theme ?? "auto",
-            palette: options.palette ?? "ink",
-            strict: options.strict ?? process.env.NODE_ENV !== "development",
-            preset: {
-                layout: "lesson",
-                density: "comfortable",
-                tone: "scholarly",
-                ...options.preset,
-            },
-            ...options,
-        };
+        this.options = mergeOptions(options, callerDir);
     }
     // ── Meta setters ────────────────────────────────────────────────────────────
     /**
@@ -373,10 +417,14 @@ export class LessonBuilder {
         const lesson = { meta: this.meta, blocks: this.blocks };
         const html = render(lesson, 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`);
+        const outPathDir = path.dirname(outPath);
+        if (!fs.existsSync(outPathDir))
+            fs.mkdirSync(outPathDir, { recursive: true });
         fs.writeFileSync(outPath, html, "utf-8");
+        if (this.options.standalone === false) {
+            copyAssets(outDir);
+        }
         const relPath = path.relative(process.cwd(), outPath);
         console.log(`  ✓ Built lesson (${this.blocks.length} blocks) → ${relPath}`);
         return outPath;
@@ -504,20 +552,7 @@ export class ChapterBuilder {
             title,
             slug,
         };
-        this.options = {
-            outDir: options.outDir ?? (callerDir ? path.join(callerDir, "out") : "./out"),
-            contentBase: options.contentBase ?? callerDir ?? ".",
-            theme: options.theme ?? "auto",
-            palette: options.palette ?? "ink",
-            strict: options.strict ?? process.env.NODE_ENV !== "development",
-            preset: {
-                layout: "lesson",
-                density: "comfortable",
-                tone: "scholarly",
-                ...options.preset,
-            },
-            ...options,
-        };
+        this.options = mergeOptions(options, callerDir);
     }
     slug(slug) {
         this.meta.slug = slug;
@@ -561,10 +596,14 @@ export class ChapterBuilder {
         const chapterData = { meta: this.meta, lessons };
         const html = renderChapter(chapterData, 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`);
+        const outPathDir = path.dirname(outPath);
+        if (!fs.existsSync(outPathDir))
+            fs.mkdirSync(outPathDir, { recursive: true });
         fs.writeFileSync(outPath, html, "utf-8");
+        if (this.options.standalone === false) {
+            copyAssets(outDir);
+        }
         const relPath = path.relative(process.cwd(), outPath);
         console.log(`  ✓ Built chapter (${this.lessonBuilders.length} lessons) → ${relPath}`);
         return outPath;

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

@@ -1 +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"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAMA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,iBAwG1C"}

package/dist/cli/dev.js

@@ -12,7 +12,7 @@ export async function runDev(args) {
         for (const entry of entryPoints) {
             const entryPath = path.join(dir, entry);
             if (fs.existsSync(entryPath)) {
-                exec(`NODE_ENV=development bun ${entryPath}`, (err, stdout, stderr) => {
+                exec(`NODE_ENV=development bun "${entryPath}"`, (err, stdout, stderr) => {
                     if (err)
                         console.error("Build failed:", stderr);
                     else {
@@ -45,8 +45,9 @@ export async function runDev(args) {
             if (srv.upgrade(req))
                 return;
             const url = new URL(req.url);
-            let filePath = path.join(outDir, url.pathname);
-            if (filePath.endsWith("/")) {
+            const decodedPath = decodeURIComponent(url.pathname);
+            let filePath = path.resolve(outDir, "." + decodedPath);
+            if (filePath.endsWith(path.sep)) {
                 const files = fs.existsSync(outDir) ? fs.readdirSync(outDir) : [];
                 const htmlFiles = files.filter(f => f.endsWith(".html"));
                 if (htmlFiles.includes("index.html")) {
@@ -61,24 +62,31 @@ export async function runDev(args) {
                         filePath = path.join(outDir, htmlFiles[0]);
                     }
                     else {
-                        filePath += "index.html";
+                        filePath = path.join(outDir, "index.html");
                     }
                 }
             }
+            if (!filePath.startsWith(outDir + path.sep) && filePath !== outDir) {
+                return new Response("Forbidden", { status: 403 });
+            }
             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 lastBodyIndex = text.lastIndexOf("</body>");
+                    if (lastBodyIndex !== -1) {
+                        text = text.slice(0, lastBodyIndex) + `<script>
 						const ws = new WebSocket("ws://localhost:3000/");
 						ws.onmessage = (e) => { if (e.data === "reload") location.reload(); };
-					</script></body>`);
+					</script></body>` + text.slice(lastBodyIndex + 7);
+                    }
                     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()) {
+            const baseDir = path.resolve(process.cwd(), dir);
+            const srcPath = path.resolve(baseDir, "." + decodedPath);
+            if (srcPath.startsWith(baseDir + path.sep) && fs.existsSync(srcPath) && fs.statSync(srcPath).isFile()) {
                 return new Response(Bun.file(srcPath));
             }
             return new Response("Not found", { status: 404 });

package/dist/cli/generate.js

@@ -26,7 +26,7 @@ export async function runGenerate(args) {
         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 name = rawName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "") || "item";
     const cwd = process.cwd();
     switch (type) {
         case "ch":

package/dist/client/app.js

@@ -15,11 +15,10 @@ function bkSimDoc(js, props, loop, dependencies) {
 		";window.bkSetupCalled=false;" +
 		'window.bkCanvasPoint=function(e,c){const r=(c||e.currentTarget||e.target).getBoundingClientRect(),w=(c&&c.__bkLogicalW)||800,h=(c&&c.__bkLogicalH)||500;return{x:(e.clientX-r.left)*w/r.width,y:(e.clientY-r.top)*h/r.height}};' +
 		'window.bkFitCanvas=function(c,reqW,reqH,o){if(!c)return{scale:1,width:reqW,height:reqH,cssScale:1};const d=window.devicePixelRatio||1;const w=reqW;const h=reqH;c.__bkLogicalW=w;c.__bkLogicalH=h;c.style.width=w+"px";c.style.height=h+"px";c.style.position="relative";c.style.left="auto";c.style.top="auto";c.style.transformOrigin="center center";const sx=window.innerWidth/w,sy=window.innerHeight/h,cssS=Math.max(sx,sy);c.style.transform="scale("+cssS+")";const pw=Math.max(1,Math.round(w*d)),ph=Math.max(1,Math.round(h*d));if(!o||o.bitmap!==false){if(c.width!==pw||c.height!==ph){c.width=pw;c.height=ph}}return{scale:d,width:w,height:h,cssScale:cssS}};' +
-		'window.bkSetup=function(w,h,f){window.bkSetupCalled=true;const c=document.getElementById("c");if(!c)return;const ctx=c.getContext("2d");let loopId=null;let fit=window.bkFitCanvas(c,w,h);function l(){if(window.innerWidth>=32&&window.innerHeight>=32){ctx.save();ctx.scale(fit.scale,fit.scale);f(ctx,fit.width,fit.height);ctx.restore()}if(window.__loop){loopId=requestAnimationFrame(l)}else{loopId=null}}function i(){if(window.innerWidth>=32&&window.innerHeight>=32){fit=window.bkFitCanvas(c,w,h);l()}else{requestAnimationFrame(i)}}i();window.addEventListener("resize",function(){fit=window.bkFitCanvas(c,w,h);if(!window.__loop&&window.innerWidth>=32&&window.innerHeight>=32&&!loopId){ctx.save();ctx.scale(fit.scale,fit.scale);f(ctx,fit.width,fit.height);ctx.restore()}});window.addEventListener("message",function(event){if(!event.data)return;if(event.data.type==="bk:play"){window.__loop=true;if(!loopId)loopId=requestAnimationFrame(l)}else if(event.data.type==="bk:pause"){window.__loop=false}});};' +
-		'window.addEventListener("message",function(event){if(!event.data||event.data.type!=="bk:set-props")return;window.__simProps=Object.assign({},window.__simProps,event.data.props);window.dispatchEvent(new CustomEvent("bk:props",{detail:window.__simProps}));});' +
+		'window.bkSetup=function(w,h,f){window.bkSetupCalled=true;const c=document.getElementById("c");if(!c)return;const ctx=c.getContext("2d");let loopId=null;let fit=window.bkFitCanvas(c,w,h);function l(){if(window.innerWidth>=32&&window.innerHeight>=32){ctx.save();ctx.scale(fit.scale,fit.scale);f(ctx,fit.width,fit.height);ctx.restore()}if(window.__loop){loopId=requestAnimationFrame(l)}else{loopId=null}}function i(){if(window.innerWidth>=32&&window.innerHeight>=32){fit=window.bkFitCanvas(c,w,h);l()}else{requestAnimationFrame(i)}}i();window.addEventListener("resize",function(){fit=window.bkFitCanvas(c,w,h);if(!window.__loop&&window.innerWidth>=32&&window.innerHeight>=32&&!loopId){ctx.save();ctx.scale(fit.scale,fit.scale);f(ctx,fit.width,fit.height);ctx.restore()}});window.addEventListener("message",function(event){if(event.source!==window.parent)return;if(!event.data)return;if(event.data.type==="bk:play"){window.__loop=true;if(!loopId)loopId=requestAnimationFrame(l)}else if(event.data.type==="bk:pause"){window.__loop=false}else if(event.data.type==="bk:set-props"){window.__simProps=Object.assign({},window.__simProps,event.data.props);window.dispatchEvent(new CustomEvent("bk:props",{detail:window.__simProps}));}});};' +
 		"try{" +
 		js +
-		'}catch(e){console.error("Simulation Error:",e);document.body.innerHTML="<div style=\'padding: 20px; color: red; font-family: monospace;\'>Error: "+e.message+"</div>"}' +
+		'}catch(e){console.error("Simulation Error:",e);const d=document.createElement("div");d.style.cssText="padding:20px;color:red;font-family:monospace";d.textContent="Error: "+e.message;document.body.innerHTML="";document.body.appendChild(d);}' +
 		"if(!window.bkSetupCalled){function fallbackScale(){window.bkFitCanvas(document.getElementById('c'),800,500,{bitmap:false});}fallbackScale();window.addEventListener('resize', fallbackScale);}" +
 		"</" + "script></body></html>"
 	);
@@ -76,27 +75,14 @@ function bkWireMaximizeControls() {
 }
 
 function bkWireInteractiveFrames() {
-	const activate = (e) => {
+	const interactiveHandler = (e) => {
 		const obj = e.target.closest?.(".bk-object");
-		if (!obj) return;
-		const frame = obj.querySelector(".bk-embed-interactive");
-		if (frame) {
-			frame.classList.add("is-interactive");
-			const iframe = frame.querySelector("iframe");
-			if (iframe && iframe.contentWindow) {
-				iframe.contentWindow.postMessage({ type: "bk:play" }, "*");
-			}
-		}
-	};
-	document.addEventListener("pointerdown", activate, { passive: true });
-	document.addEventListener("focusin", activate, { passive: true });
+		const activateFrame = obj ? obj.querySelector(".bk-embed-interactive") : null;
 
-	const exitInteractive = (e) => {
 		document
 			.querySelectorAll(".bk-embed-interactive.is-interactive")
 			.forEach((frame) => {
-				const container = frame.closest(".bk-object") || frame;
-				if (!container.contains(e.target)) {
+				if (frame !== activateFrame) {
 					frame.classList.remove("is-interactive");
 					const iframe = frame.querySelector("iframe");
 					if (iframe && iframe.contentWindow) {
@@ -104,9 +90,17 @@ function bkWireInteractiveFrames() {
 					}
 				}
 			});
+
+		if (activateFrame && !activateFrame.classList.contains("is-interactive")) {
+			activateFrame.classList.add("is-interactive");
+			const iframe = activateFrame.querySelector("iframe");
+			if (iframe && iframe.contentWindow) {
+				iframe.contentWindow.postMessage({ type: "bk:play" }, "*");
+			}
+		}
 	};
-	document.addEventListener("pointerdown", exitInteractive, { passive: true });
-	document.addEventListener("focusin", exitInteractive, { passive: true });
+	document.addEventListener("pointerdown", interactiveHandler, { passive: true });
+	document.addEventListener("focusin", interactiveHandler, { passive: true });
 
 	const obs = new IntersectionObserver((entries) => {
 		entries.forEach((e) => {
@@ -192,6 +186,9 @@ function bkBroadcastTheme(targetWindow) {
 }
 
 window.addEventListener("message", function(e) {
+	const isValidSource = Array.from(document.querySelectorAll("iframe")).some(f => f.contentWindow === e.source);
+	if (!isValidSource) return;
+
 	if (e.data && e.data.type === "bk:request-theme") {
 		// Small delay to ensure CSS has applied if this happens right on load
 		requestAnimationFrame(() => bkBroadcastTheme(e.source));
@@ -266,13 +263,16 @@ function bkWireThemeControls() {
 
 	if (savedTheme) {
 		updateThemeBtn(savedTheme);
+		root.setAttribute("data-theme", savedTheme);
 	}
 	if (savedPalette) {
 		const normalizedPalette = savedPalette === "green" ? "field" : savedPalette;
 		updatePaletteBtn(normalizedPalette);
+		root.setAttribute("data-palette", normalizedPalette);
 	}
 	if (savedUi) {
 		updateUiBtn(savedUi);
+		root.setAttribute("data-ui", savedUi);
 	}
 
 	button &&
@@ -344,15 +344,44 @@ function bkWireThemeControls() {
 }
 
 // Quiz interaction
-// biome-ignore lint/correctness/noUnusedVariables: Used in generated HTML
 function bkAnswer(btn, qid) {
-	// biome-ignore lint/correctness/noUnusedVariables: Kept for clarity
-	const isCorrect = btn.dataset.correct === "true";
 	const question = document.getElementById(qid);
+	if (!question) return;
+	const quiz = question.closest(".bk-quiz");
+	const dataEl = quiz ? quiz.querySelector(".bk-quiz-data") : null;
+	let isCorrect = false;
+	
+	if (dataEl) {
+		try {
+			const answers = JSON.parse(dataEl.textContent || "[]");
+			// qid is format "quiz-IDX-qQI"
+			const match = qid.match(/-q(\d+)$/);
+			if (match) {
+				const qi = parseInt(match[1], 10);
+				const optIdx = parseInt(btn.dataset.optIdx, 10);
+				isCorrect = answers[qi] === optIdx;
+			}
+		} catch(e) {}
+	}
+
 	question.querySelectorAll(".bk-opt").forEach((b) => {
-		if (b.dataset.correct === "true") {
+		b.disabled = true; // Disable buttons for screen readers
+		const optIdx = parseInt(b.dataset.optIdx, 10);
+		// If we know the answer, highlight it
+		if (dataEl) {
+			try {
+				const answers = JSON.parse(dataEl.textContent || "[]");
+				const match = qid.match(/-q(\d+)$/);
+				if (match && answers[parseInt(match[1], 10)] === optIdx) {
+					b.classList.add("correct");
+					return;
+				}
+			} catch(e) {}
+		}
+		
+		if (b === btn && isCorrect) {
 			b.classList.add("correct");
-		} else if (b === btn) {
+		} else if (b === btn && !isCorrect) {
 			b.classList.add("wrong");
 		} else {
 			b.classList.add("disabled");

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,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,CAiRxC;AA2MD,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,CA4RxC;AAyMD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/renderer/blocks.js

@@ -176,7 +176,17 @@ function renderBlockInner(block, idx, options) {
               loading="lazy"
               style="width:100%;height:100%;border:none;display:block;">
             </iframe>
-          </div>`, "neutral"),
+          </div>
+          <script>
+            if (!window._bkYtBlurSetup) {
+              window._bkYtBlurSetup = true;
+              window.addEventListener('mousemove', function() {
+                if (document.activeElement && document.activeElement.tagName === 'IFRAME') {
+                  document.activeElement.blur();
+                }
+              }, { passive: true });
+            }
+          </script>`, "neutral"),
             };
         }
         case "latex": {
@@ -191,7 +201,7 @@ function renderBlockInner(block, idx, options) {
         case "columns": {
             return {
                 html: blockChrome("Columns", block.label, block.caption, `<div class="bk-columns" style="grid-template-columns:${block.columns
-                    .map((column) => column.width ?? "minmax(0, 1fr)")
+                    .map((column) => escAttr(column.width ?? "minmax(0, 1fr)"))
                     .join(" ")}">
             ${block.columns
                     .map((column) => {
@@ -236,6 +246,7 @@ function renderBlockInner(block, idx, options) {
           <div class="bk-quiz-body">
             ${quiz.questions.map((q, qi) => renderQuestion(q, `quiz-${idx}`, qi)).join("\n")}
           </div>
+          <script type="application/json" class="bk-quiz-data">${escapeScriptJson(quiz.questions.map(q => q.answer))}</script>
         </div>`,
                 navItems: [{
                         id: `quiz-${idx}`,
@@ -254,7 +265,7 @@ function renderQuestion(q, quizId, qi) {
     const qid = `${quizId}-q${qi}`;
     const options = q.options
         .map((opt, oi) => `
-    <button class="bk-opt" data-correct="${oi === q.answer}" onclick="bkAnswer(this,'${qid}')">
+    <button class="bk-opt" data-opt-idx="${oi}" onclick="bkAnswer(this,'${escAttr(qid)}')">
       <span class="bk-opt-dot"></span><span class="bk-opt-text">${mdInline(opt)}</span>
     </button>`)
         .join("");
@@ -423,10 +434,14 @@ window.addEventListener("message", (event) => {
   window.dispatchEvent(new CustomEvent("bk:props", { detail: window.__simProps }));
 });
 try {
-  ${js}
+  ${js.replace(/<\/script>/gi, "<\\/script>")}
 } catch (e) {
   console.error("Simulation Error:", e);
-  document.body.innerHTML = '<div style="padding:20px;color:red;font-family:monospace">Error: ' + e.message + '</div>';
+  const errDiv = document.createElement('div');
+  errDiv.style.cssText = "padding:20px;color:red;font-family:monospace";
+  errDiv.textContent = 'Error: ' + e.message;
+  document.body.innerHTML = '';
+  document.body.appendChild(errDiv);
 }
 if (!window.bkSetupCalled) {
   function fallbackScale() {
@@ -437,12 +452,6 @@ if (!window.bkSetupCalled) {
 }
 </script>
 </body></html>`;
-    // We use double quotes for the srcdoc attribute, so we must escape them.
-    return doc
-        .replace(/&/g, "&amp;")
-        .replace(/"/g, "&quot;")
-        .replace(/'/g, "&#39;")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;");
+    return escAttr(doc);
 }
 export { blockChrome, renderBlock, renderBlockInner };

package/dist/renderer/html.d.ts

@@ -1,6 +1,7 @@
 import type { BuildOptions, Lesson } from "../types.js";
 import type { NavItem } from "./utils.js";
 declare function renderNavItem(item: NavItem): string;
+export declare function renderLayout(title: string, description: string | undefined, navHtml: string, contentHtml: string, opts: BuildOptions, extraSidebar?: string): string;
 declare function renderPage(lesson: Lesson, navItems: NavItem[], bodyHtml: string, opts: BuildOptions): string;
 declare function pageCSS(): string;
 declare function clientScript(): string;

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

@@ -1 +1 @@
-{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/renderer/html.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,iBAAS,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAU5C;AAsBD,iBAAS,UAAU,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,GAChB,MAAM,CA6HR;AAID,iBAAS,OAAO,IAAI,MAAM,CAKzB;AAID,iBAAS,YAAY,IAAI,MAAM,CAE9B;AAED,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/renderer/html.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,iBAAS,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAU5C;AAsBD,wBAAgB,YAAY,CAC3B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,EAClB,YAAY,GAAE,MAAW,GACvB,MAAM,CA6GR;AAED,iBAAS,UAAU,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,GAChB,MAAM,CA8BR;AAID,iBAAS,OAAO,IAAI,MAAM,CAKzB;AAID,iBAAS,YAAY,IAAI,MAAM,CAE9B;AAED,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC"}

package/dist/renderer/html.js

@@ -34,7 +34,7 @@ function renderEndNav(lesson) {
     ` : `<div class="bk-end-link" style="visibility:hidden"></div>`}
   </nav>`;
 }
-function renderPage(lesson, navItems, bodyHtml, opts) {
+export function renderLayout(title, description, navHtml, contentHtml, opts, extraSidebar = "") {
     const theme = opts.theme ?? "light";
     const schemeAttr = `data-theme="${theme}"`;
     const preset = opts.preset ?? {};
@@ -43,8 +43,7 @@ function renderPage(lesson, navItems, bodyHtml, opts) {
     const tone = preset.tone ?? "scholarly";
     const palette = opts.palette ?? "ink";
     const ui = opts.ui ?? "standard";
-    const navHtml = navItems.map(renderNavItem).join("\n");
-    const endNavHtml = renderEndNav(lesson);
+    const safeFont = opts.font ? opts.font.replace(/[;{}<>\\]/g, "") : "";
     return `<!DOCTYPE html>
 <html lang="en" data-palette="${palette}" data-ui="${ui}" ${schemeAttr}>
 <head>
@@ -61,26 +60,21 @@ function renderPage(lesson, navItems, bodyHtml, opts) {
 </script>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>${escHtml(lesson.meta.title)}</title>
-${lesson.meta.description ? `<meta name="description" content="${escHtml(lesson.meta.description)}">` : ""}
+<title>${escHtml(title)}</title>
+${description ? `<meta name="description" content="${escHtml(description)}">` : ""}
 <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.47/dist/katex.min.css">
 <link href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,650;9..144,760&family=IBM+Plex+Sans:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500&family=Archivo:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&family=Syne:wght@600;700;800&family=Playfair+Display:ital,wght@0,400..700;1,400..700&family=Lora:ital,wght@0,400..700;1,400..700&display=swap" rel="stylesheet">
 <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/highlight.js@11.11.1/styles/github-dark.min.css">
 ${opts.head ?? ""}
-<style>
-${opts.font ? `:root { --font-sans: ${opts.font}, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }` : ""}
-${pageCSS()}
-</style>
+${opts.standalone === false ? `<link rel="stylesheet" href="assets/theme.css?v=${Date.now()}">` : `<style>\n${safeFont ? `:root { --font-sans: ${safeFont}, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }` : ""}\n${pageCSS()}\n</style>`}
 </head>
 <body class="bk-layout-${layout} bk-density-${density} bk-tone-${tone}">
 <div class="bk-shell">
   <aside class="bk-sidebar">
     <div class="bk-sidebar-inner">
       <div class="bk-sidebar-header">
-        ${lesson.meta.parentSlug ? `<div style="margin-top: 8px;"><a href="${lesson.meta.parentSlug}.html" class="bk-back-link" aria-label="Back to Chapter" style="margin-bottom: 12px;"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M19 12H5"/><path d="M12 19l-7-7 7-7"/></svg>Back to Chapter</a></div>` : `<div style="margin-top: 8px;"></div>`}
-        <div class="bk-sidebar-title">${escHtml(lesson.meta.title)}</div>
-        ${lesson.meta.author ? `<div class="bk-sidebar-author">By ${escHtml(lesson.meta.author)}</div>` : ""}
-        ${lesson.meta.tags?.length ? `<div class="bk-tag-row">${lesson.meta.tags.map((tag) => `<span>${escHtml(tag)}</span>`).join("")}</div>` : ""}
+        ${extraSidebar}
+        <div class="bk-sidebar-title">${escHtml(title)}</div>
       </div>
       <nav class="bk-nav">${navHtml}</nav>
       <div class="bk-sidebar-footer">
@@ -142,6 +136,22 @@ ${pageCSS()}
     <button class="bk-sidebar-expand" id="bk-sidebar-expand" type="button" aria-label="Expand sidebar">
       <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 18l6-6-6-6"/></svg>
     </button>
+    ${contentHtml}
+  </main>
+</div>
+${opts.standalone === false ? `<script src="assets/app.js?v=${Date.now()}"></script>` : `<script>\n${clientScript()}\n</script>`}
+</body>
+</html>`;
+}
+function renderPage(lesson, navItems, bodyHtml, opts) {
+    const navHtml = navItems.map(renderNavItem).join("\n");
+    const endNavHtml = renderEndNav(lesson);
+    const extraSidebar = `
+		${lesson.meta.parentSlug ? `<div style="margin-top: 8px;"><a href="${lesson.meta.parentSlug}.html" class="bk-back-link" aria-label="Back to Chapter" style="margin-bottom: 12px;"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M19 12H5"/><path d="M12 19l-7-7 7-7"/></svg>Back to Chapter</a></div>` : `<div style="margin-top: 8px;"></div>`}
+	`;
+    const authorHtml = lesson.meta.author ? `<div class="bk-sidebar-author">By ${escHtml(lesson.meta.author)}</div>` : "";
+    const tagsHtml = lesson.meta.tags?.length ? `<div class="bk-tag-row">${lesson.meta.tags.map((tag) => `<span>${escHtml(tag)}</span>`).join("")}</div>` : "";
+    const contentHtml = `
     <article class="bk-content">
       <header class="bk-hero">
         <p class="bk-eyebrow">Interactive Lesson</p>
@@ -151,13 +161,8 @@ ${pageCSS()}
       ${bodyHtml}
       ${endNavHtml}
     </article>
-  </main>
-</div>
-<script>
-${clientScript()}
-</script>
-</body>
-</html>`;
+	`;
+    return renderLayout(lesson.meta.title, lesson.meta.description, navHtml, contentHtml, opts, extraSidebar + authorHtml + tagsHtml);
 }
 // ─── CSS ──────────────────────────────────────────────────────────────────────
 function pageCSS() {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/renderer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOjE,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,CAatE;AAID,wBAAgB,aAAa,CAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,YAAiB,GACrB,MAAM,CAqYR"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/renderer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOjE,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,CAatE;AAID,wBAAgB,aAAa,CAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,YAAiB,GACrB,MAAM,CAuTR"}