jsmdcui 0.9.0 → 0.11.1

package/src/index.js

@@ -128,7 +128,7 @@ import { isHex3Encoding, isMdcuiEncoding } from "./runtime/encodings.js";
 import { createInterface } from "node:readline/promises";
 
 import pkg from "../package.json" with { type: "json" };
-import { REPO_ROOT,IS_COMPILED, buildExecutable,buildEarlyExit } from "../single-exe/compiled.js";
+import { REPO_ROOT,IS_COMPILED, buildExecutable,buildEarlyExit,stringifyNonPrimitiveDefineValues } from "../single-exe/compiled.js";
 
 
 const __filename = fileURLToPath(import.meta.url);
@@ -181,6 +181,12 @@ const VERSION = pkg.version;
 const SINGLE_EXE_DIR = resolve(REPO_ROOT, "single-exe");
 const SINGLE_EXE_ENTRY = resolve(SINGLE_EXE_DIR, "entry.mjs");
 const DEFAULT_BUILD_OUTFILE = "mdcui";
+const MDCUI_DEFAULT_EDIT_ENABLED = typeof MDCUI_DEFAULT_EDIT !== "undefined";
+const MDCUI_DEFAULT_DEMO_ENABLED = typeof MDCUI_DEFAULT_DEMO !== "undefined";
+const MDCUI_DEFAULT_DEMO_WUI_ENABLED = typeof MDCUI_DEFAULT_DEMO_WUI !== "undefined";
+const MDCUI_OVERWRITE_DEMO_ENABLED = typeof MDCUI_OVERWRITE_DEMO !== "undefined";
+let defaultEdit = false;
+let noRuntimeArgs = false;
 const decoder = new TextDecoder();
 let _activeTtyStream = null; // set in App.start() for use by the global error handler
 
@@ -340,7 +346,7 @@ function normalizeEncodingLabel(encoding = "utf-8") {
 
 function encodingForPath(pathOrUrl, encoding = DEFAULT_SETTINGS.encoding, inferMdcui = true) {
   const normalized = normalizeEncodingLabel(encoding);
-  if (normalized !== "utf-8" || !inferMdcui) return normalized;
+  if (normalized !== "utf-8" || !inferMdcui || defaultEdit) return normalized;
   let pathname = String(pathOrUrl ?? "").replace(/[?#].*$/, "");
   try {
     if (isHttpUrl(pathname)) pathname = new URL(pathname).pathname;
@@ -1092,6 +1098,8 @@ function parseArgs(argv) {
     clean: false,
     check: false,
     cat: false,
+    wui: false,
+    printUi: false,
     docs: false,
     exportReadme: false,
     exportCdpMaze: false,
@@ -1099,6 +1107,7 @@ function parseArgs(argv) {
     testapp: false,
     demoList: false,
     demo: null,
+    overwriteDemo: false,
     allowUrl: false,
     buildExe: false,
     buildFor: "",
@@ -1122,6 +1131,8 @@ function parseArgs(argv) {
     else if (arg === "-clean") flags.clean = true;
     else if (arg === "--check") flags.check = true;
     else if (arg === "--cat" || arg === "-cat" || arg === "--ccat" || arg === "-ccat" || arg === "--bat" || arg === "-bat" || arg === "--glow" || arg === "-glow") flags.cat = true;
+    else if (arg === "--wui") flags.wui = true;
+    else if (arg === "--print-ui") flags.printUi = true;
     else if (arg === "--xxd" || arg === "--hexdump") {
       flags.cat = true;
       flags.settings.set("encoding", "hex3");
@@ -1138,12 +1149,16 @@ function parseArgs(argv) {
     else if (arg === "--edit") {
       flags.settings.set("encoding", "utf-8");
     }
+    else if (arg === "--mdcui" || arg === "--tui") {
+      flags.settings.set("encoding", "mdcui");
+    }
     else if (arg === "--docs" || arg === "--readme") flags.docs = true;
     else if (arg === "--export-readme") flags.exportReadme = true;
     else if (arg === "--export-cdp-maze") flags.exportCdpMaze = true;
     else if (arg === "--changelog") flags.changelog = true;
     else if (arg === "--testapp.md") flags.testapp = true;
     else if (arg === "--demo-list") flags.demoList = true;
+    else if (arg === "--overwrite-demo") flags.overwriteDemo = true;
     else if (arg === "--cdp-maze") {
       flags.cdpMaze = true;
       flags.demo = { option: arg, filename: "maze.md", asset: "demos/maze.md" };
@@ -1159,9 +1174,15 @@ function parseArgs(argv) {
     }
     else if (arg.startsWith("--demo-")) {
       const name = arg.slice("--demo-".length);
-      flags.demo = /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name)
+      flags.demo = isValidDemoName(name)
         ? { option: arg, filename: `${name}.md`, asset: `demos/${name}.md` }
-        : { option: arg, error: "demo filename must contain only letters, numbers, dots, underscores, and hyphens" };
+        : {
+            option: arg,
+            error:
+              "demo filename must start with a Unicode letter or number "
+              + "and contain only Unicode letters, numbers, dots, underscores, "
+              + "or hyphens; whitespace is not allowed",
+          };
     }
     else if (arg === "--allow-url") flags.allowUrl = true;
     else if (arg === "--kitty") flags.kittyMode = "extended";
@@ -1192,20 +1213,70 @@ function parseArgs(argv) {
   return { flags, files };
 }
 
+function isValidDemoName(name) {
+  return /^[\p{L}\p{N}][\p{L}\p{N}\p{M}._-]*$/u.test(String(name));
+}
+
+function demoNameFromMarkdownBasename(filename) {
+  const value = String(filename);
+  if (!value.endsWith(".md")) return "";
+  const name = value.slice(0, -".md".length);
+  return isValidDemoName(name) ? name : "";
+}
+
 function usage() {
   return [
     `Usage:
-  ${pkg.name} [OPTIONS] [FILE.md]
+  ${pkg.name} [OPTIONS] [FILE]
+    
+Execute .md:
+  ${pkg.name} [FILE.md]
   ${pkg.name} --wui [FILE.md]
+Develop .md:
+  ${pkg.name} --edit [FILE.md]
+  ${pkg.name} --check <FILE.md>
 
 Modes:
-  --check FILE.md
-      Check heading and fenced-block IDs for collisions, print details, and exit
-      Exits 0 when IDs are unique, 1 on collisions, and 2 on usage/read errors
+  --tui, --mdcui, -encoding mdcui
+    .md files use this by default
+    Execute a Markdown App
+      Create a Terminal UI
+    Generate & overwrite
+      .front.js, .back.js, 
+      .html, -rpc.js, -server.js
+      beside the .md file
+      
   --wui [FILE.md]
-      Generate or overwrite Markdown UI files beside FILE.md and start the server
-      Without FILE.md, use the existing ./testapp.md without overwriting it
+    Execute a Markdown App
+      Create a Web UI
+      Start a web server
+    Generate & overwrite 
+      .front.js, .back.js, 
+      .html, -rpc.js, -server.js
+      beside the .md file
+      
+    Without FILE.md, 
+    default to ./testapp.md
       If ./testapp.md is missing, write the bundled demo there first
+    Combine with any --demo option to start that demo as a Web UI
+      
+  --print-ui
+    Must be combined with --wui
+    Print the generated TUI, raw ANSI, and HTML before starting the server
+    
+  --kitty
+    Display Markdown images with Kitty graphics and the jsgotty MIME extension
+  --kitty-compat
+    Display Markdown images with Kitty graphics without the non-standard MIME U field
+      
+  --edit
+    Open files as editable UTF-8 text
+    Override .md mdcui detection
+    
+  --check <FILE.md>
+    Check heading and fenced-block IDs for collisions, print details, and exit
+    Exits 0 when IDs are unique, 1 on collisions, and 2 on usage/read errors
+      
   --cat, --ccat, --bat, --glow
       Render file(s) and write to stdout, then exit (.md uses mdcui/createTui)
       A local .md file also writes or overwrites five generated files beside it
@@ -1214,15 +1285,6 @@ Modes:
   --hex3, --hex3gz, --hex3zst
       Set -encoding hex3, hex3gz, or hex3zst for this session
       hex3 shows raw bytes; gz/zst variants compress the same hex3 view
-  --edit
-      Open files as editable UTF-8 text, overriding .md mdcui detection
-  -encoding mdcui
-      Render Markdown through runmd.mjs#createTui; .md files use this automatically
-      Writes .front.js, .back.js, .html, -rpc.js, and -server.js beside the .md file
-  --kitty
-      Display Markdown images with Kitty graphics and the jsgotty MIME extension
-  --kitty-compat
-      Display Markdown images with Kitty graphics without the non-standard MIME U field
 
 Settings:
   -SETTING VALUE
@@ -1230,54 +1292,73 @@ Settings:
   -options
       List all setting names and defaults, then exit.
 
-CDP:
+CDP(Chrome DevTools Protocol):
   --cdp-maze
       Open the maze demo, start CDP on localhost:9222, and solve it automatically
+  --export-cdp-maze
+      Write or overwrite ./cdp-maze.js with the bundled CDP maze solver & exit
+      
   --remote-debugging-port=PORT
       Start CDP (Chrome DevTools Protocol) server on PORT at launch
   --remote-debugging-address=ADDRESS
       Bind CDP server to ADDRESS (default: 127.0.0.1); use 0.0.0.0 for all interfaces
 
 Information:
-  -help, -h, --help
+  --help, -h, -help
       Show this help & exit
-  -version, -V, --version
+  --version, -V, -version
       Show version+backend info & exit
-  --docs, --readme
+      
+  --readme, --docs
       Show ${pkg.name}'s README.md & exit
   --export-readme
       Write or overwrite ./README.md with the bundled README.md & exit
-  --export-cdp-maze
-      Write or overwrite ./cdp-maze.js with the bundled CDP maze solver & exit
+      
   --changelog
       Show CHANGELOG.md & exit
-  -profile, --profile
+  --profile, -profile
       Print startup performance profile and exit
 
 Demo:
   --testapp.md
-      Write the bundled testapp.md to stdout & exit
+      Print the bundled testapp.md to stdout & exit
   --demo-list
-      List the bundled demos and their command-line options, then exit
+      List the bundled demos & exit
+      
   --demo
-      Use the existing ./testapp.md without overwriting it, or write the bundled demo if missing
+      Execute an existing ./testapp.md
+      Or write the bundled demo if missing
       Open it in the TUI and write 5 generated files beside it
+      
   --demo-<filename>
-      Load demos/<filename>.md, preserving an existing ./<filename>.md or writing the bundled copy
+      Execute an existing <filename>.md
+      Or write the bundled demos/<filename>.md if missing
       Open it in the TUI and write 5 generated files beside it
       For example: --demo-select, --demo-todo, or --demo-todo-zh
+      
   --demo-imgtool
       Alias for --demo-image-processor
   --demo-imgtool-zh
       Alias for --demo-image-processor.zh-TW
 
+  --overwrite-demo
+      Overwrite an existing local demo with the bundled copy; combine with any --demo option
+      
 Remote Markdown:
   --allow-url
       Download HTTP(S) Markdown and, with Kitty mode, its HTTP(S) images; allow its code to run
 
-Experimental:
-  --build-exe                   Build a Bun single-file executable and exit
-  --build-for <target>          Build a Bun single-file executable for target`
+Experimental single-exe:
+  --build-exe [BUN_ARGS...]
+      Build a Bun single-file executable & exit
+  --build-for <target> [BUN_ARGS...]
+      Build a Bun single-file executable for target & exit
+  
+  [BUN_ARGS...]
+      --define MDCUI_XXX=1
+        More info in --readme
+      https://bun.com/docs/bundler/executables
+`
   ].join("\n");
 }
 
@@ -1337,6 +1418,7 @@ class BufferModel {
     this._mdcuiFenceEvents = isMdcuiEncoding(this.encoding) ? fenceEventMap(sourceText ?? tuiSourceText ?? text) : new Map();
     this._mdcuiImages = isMdcuiEncoding(this.encoding) ? (mdcuiImages ?? []) : [];
     this._mdcuiRenderWidth = Math.trunc(Number(mdcuiRenderWidth) || 0);
+    this._useBundledMdcuiModules = false;
     this.cursor = { x: 0, y: 0 };
     this.scroll = { x: 0, y: 0, row: 0 };
     this._modified = false;
@@ -4477,7 +4559,10 @@ class App {
     ) return false;
 
     const frontPath = `${buf.path}.front.js`;
-    if (!existsSync(frontPath)) return false;
+    const useBundledMdcuiModules = Boolean(
+      global.MDCUI_MAIN && buf._useBundledMdcuiModules,
+    );
+    if (!useBundledMdcuiModules && !existsSync(frontPath)) return false;
     try {
       const selection = globalThis.$?.(`${declaration.tag}#${id}`);
       const target = {
@@ -4492,8 +4577,12 @@ class App {
       });
       const event = tuiKeyEventForFront(inputEvent, target, eventName);
       const [{ evalFront }, frontMod] = await Promise.all([
-        import("./cui/rpc.mjs"),
-        import(localModuleUrl(frontPath)),
+        useBundledMdcuiModules
+          ? import(global.MDCUI_MAIN + "-rpc.js")
+          : import("./cui/rpc.mjs"),
+        useBundledMdcuiModules
+          ? import(global.MDCUI_MAIN + ".front.js")
+          : import(localModuleUrl(frontPath)),
       ]);
       const result = await evalFront(frontMod, code, { event });
       if (result && typeof result === "object" && result.ok === false) {
@@ -4528,9 +4617,16 @@ class App {
     { // defaultCallback
       if (payload.link && /^javascript:/i.test(payload.link) && buf?.path && !isHttpUrl(buf.path)) {
         try {
+          const useBundledMdcuiModules = Boolean(
+            global.MDCUI_MAIN && buf._useBundledMdcuiModules,
+          );
           const [{ evalFront }, frontMod] = await Promise.all([
-            import("./cui/rpc.mjs"),
-            import(localModuleUrl(`${buf.path}.front.js`)),
+            useBundledMdcuiModules
+              ? import(global.MDCUI_MAIN + "-rpc.js")
+              : import("./cui/rpc.mjs"),
+            useBundledMdcuiModules
+              ? import(global.MDCUI_MAIN + ".front.js")
+              : import(localModuleUrl(`${buf.path}.front.js`)),
           ]);
           const result = await evalFront(frontMod, payload.link);
           if (result && typeof result === "object" && result.ok === false) {
@@ -5418,10 +5514,18 @@ class App {
     const frontPath = buffer.path && !isHttpUrl(buffer.path)
       ? `${buffer.path}.front.js`
       : "";
-    if (!frontPath || !existsSync(frontPath)) return;
+    const useBundledMdcuiModules = Boolean(
+      global.MDCUI_MAIN && buffer._useBundledMdcuiModules,
+    );
+    if (
+      !useBundledMdcuiModules
+      && (!frontPath || !existsSync(frontPath))
+    ) return;
 
     try {
-      const frontMod = await import(localModuleUrl(frontPath));
+      const frontMod = useBundledMdcuiModules
+        ? await import(global.MDCUI_MAIN + ".front.js")
+        : await import(localModuleUrl(frontPath));
       if (typeof frontMod.onMdcuiExit !== "function") return;
       await frontMod.onMdcuiExit({
         reason,
@@ -6958,6 +7062,11 @@ function makeBufferAdapter(buffer) {
     get Name()     { return buffer.Name ?? buffer.name ?? ""; },
     get Modified() { return buffer.modified ?? false; },
     get Settings() { return buffer.Settings; },
+    get MdcuiModuleSource() {
+      return global.MDCUI_MAIN && buffer._useBundledMdcuiModules
+        ? "embedded"
+        : "external";
+    },
     Line: (...args) => buffer.Line(Number(lastArg(args))),
     Insert: (...args) => insertAtLoc(buffer, decodeLoc(args.at(-2)), String(args.at(-1))),
     Replace: (...args) => replaceAtLocs(buffer, decodeLoc(args.at(-3)), decodeLoc(args.at(-2)), String(args.at(-1))),
@@ -8073,19 +8182,182 @@ function printDemoList() {
   console.log("  --demo-imgtool-zh  --demo-image-processor.zh-TW");
 }
 
+async function prepareDemo(flags, rawFiles) {
+  if (!flags.demo) return { ok: true };
+  if (flags.demo.error) {
+    console.error(`Invalid demo option ${flags.demo.option}: ${flags.demo.error}`);
+    process.exitCode = 2;
+    return { ok: false };
+  }
+  let demoSource;
+  try {
+    demoSource = await bundledMarkdownSource(flags.demo.asset);
+  } catch {
+    console.error(`Unknown demo ${flags.demo.option}: ${flags.demo.asset} was not found`);
+    process.exitCode = 2;
+    return { ok: false };
+  }
+
+  const demoPath = resolve(flags.demo.filename);
+  const demoFile = Bun.file(demoPath);
+  const demoExists = await demoFile.exists();
+  const writeBundledContent = flags.overwriteDemo || !demoExists;
+  const bundledByteLength = Buffer.byteLength(demoSource);
+  const demoByteLength = writeBundledContent
+    ? bundledByteLength
+    : demoFile.size;
+  const configuredMainBase = String(
+    global.MDCUI_MAIN_BASE
+      || (global.MDCUI_MAIN ? basename(String(global.MDCUI_MAIN)) : ""),
+  );
+  const isConfiguredMainDemo = Boolean(
+    global.MDCUI_MAIN
+    && configuredMainBase
+    && basename(demoPath) === configuredMainBase,
+  );
+
+  if (writeBundledContent) {
+    await Bun.write(demoPath, demoSource);
+  } else if (isConfiguredMainDemo && demoByteLength !== bundledByteLength) {
+    console.error(
+      `[mdcui] ${demoPath} differs from the bundled demo `
+      + `(${demoByteLength} bytes vs ${bundledByteLength} bytes). `
+      + "The edited demo may not work correctly if it imports companion modules "
+      + "instead of keeping all application code in the Markdown file.",
+    );
+  }
+
+  rawFiles.splice(0, rawFiles.length, demoPath);
+  return {
+    ok: true,
+    path: demoPath,
+    useBundledModules: isConfiguredMainDemo
+      && demoByteLength === bundledByteLength,
+  };
+}
+
+function stringDefineFromArgv(argv, name) {
+  const prefix = `${name}=`;
+  for (let i = 0; i < argv.length; i++) {
+    let definition = "";
+    if (argv[i] === "--define") definition = argv[i + 1] ?? "";
+    else if (argv[i].startsWith("--define="))
+      definition = argv[i].slice("--define=".length);
+    if (!definition.startsWith(prefix)) continue;
+    try {
+      const value = JSON.parse(definition.slice(prefix.length));
+      return typeof value === "string" ? value : "";
+    } catch {
+      return "";
+    }
+  }
+  return "";
+}
+
 async function main() {
-  if (process.argv[2] === "--wui") {
-    process.argv.splice(2, 1);
+  addCheckpoint("Argument Parsing");
+
+  stringifyNonPrimitiveDefineValues(process.argv, "global.MDCUI_MAIN");
+  const argvMdcuiMain = stringDefineFromArgv(
+    process.argv,
+    "global.MDCUI_MAIN",
+  );
+  let sourceMdcuiMain = "";
+  if (IS_COMPILED) {
+    sourceMdcuiMain = "";
+  } else {
+    sourceMdcuiMain = String(argvMdcuiMain || global.MDCUI_MAIN || "");
+  }
+
+  if (sourceMdcuiMain) {
+    const mdcuiMain = resolve(sourceMdcuiMain);
+    const mdcuiMainBase = basename(mdcuiMain);
+    const mdcuiMainDemoName = demoNameFromMarkdownBasename(mdcuiMainBase);
+    if (!mdcuiMainDemoName) {
+      throw new Error(
+        "MDCUI_MAIN basename must end with lowercase .md, start with a "
+        + "Unicode letter or number, and contain no whitespace; only Unicode "
+        + "letters, numbers, dots, underscores, and hyphens are allowed",
+      );
+    }
     const runmd = await import("../runmd.mjs");
-    await runmd.main();
-    return;
+    const mdcuiMainFile = Bun.file(mdcuiMain);
+    if (!(await mdcuiMainFile.exists())) {
+      throw new Error(`MDCUI_MAIN file not found: ${mdcuiMain}`);
+    }
+    let markdown = await mdcuiMainFile.text();
+    const demoPath = join(REPO_ROOT, "demos", mdcuiMainBase);
+    if (resolve(mdcuiMain) !== resolve(demoPath)) {
+      await Bun.write(demoPath, markdown);
+    }
+    markdown = await runmd.extractJs(markdown, mdcuiMain, {
+      bundling: true,
+    });
+    await runmd.createWui(markdown, mdcuiMain, {
+      bundling: true,
+    });
+
+    if (
+      process.argv.includes("--build-for")
+      || process.argv.includes("--build-exe")
+    ) {
+      if (argvMdcuiMain) {
+        const normalizedDefine =
+          `global.MDCUI_MAIN=${JSON.stringify(mdcuiMain)}`;
+        for (let i = 0; i < process.argv.length; i++) {
+          if (
+            process.argv[i] === "--define"
+            && process.argv[i + 1]?.startsWith("global.MDCUI_MAIN=")
+          ) {
+            process.argv[i + 1] = normalizedDefine;
+          } else if (
+            process.argv[i].startsWith("--define=global.MDCUI_MAIN=")
+          ) {
+            process.argv[i] = `--define=${normalizedDefine}`;
+          }
+        }
+      } else {
+        process.argv.push(
+          "--define",
+          `global.MDCUI_MAIN=${JSON.stringify(mdcuiMain)}`,
+        );
+      }
+      process.argv.push(
+        "--define",
+        `global.MDCUI_MAIN_BASE=${JSON.stringify(mdcuiMainBase)}`,
+      );
+    }
   }
 
-  addCheckpoint("Argument Parsing");
-  
   await buildEarlyExit(null,DEFAULT_BUILD_OUTFILE)
+  defaultEdit = await Bun.file(join(REPO_ROOT, "src", "MDCUI_DEFAULT_EDIT")).exists();
   
-  const { flags, files: rawFiles } = parseArgs(process.argv.slice(2));
+  const runtimeArgs = process.argv.slice(2);
+  noRuntimeArgs = runtimeArgs.length === 0;
+  if (MDCUI_DEFAULT_EDIT_ENABLED) runtimeArgs.unshift("--edit");
+  if (noRuntimeArgs && MDCUI_DEFAULT_DEMO_ENABLED) runtimeArgs.push("--demo");
+  if (noRuntimeArgs && MDCUI_DEFAULT_DEMO_WUI_ENABLED) runtimeArgs.push("--wui");
+  if (
+    noRuntimeArgs
+    && (global.MDCUI_MAIN || global.MDCUI_MAIN_BASE)
+  ) {
+    const mdcuiMainBase = String(
+      global.MDCUI_MAIN_BASE || basename(String(global.MDCUI_MAIN)),
+    );
+    const demoName = demoNameFromMarkdownBasename(mdcuiMainBase);
+    if (!demoName) {
+      console.error(
+        "Invalid MDCUI_MAIN_BASE: expected a lowercase .md basename with "
+        + "Unicode letters or numbers and no whitespace",
+      );
+      process.exitCode = 2;
+      return;
+    }
+    runtimeArgs.push(`--demo-${demoName}`);
+  }
+  if (MDCUI_OVERWRITE_DEMO_ENABLED) runtimeArgs.push("--overwrite-demo");
+  const { flags, files: rawFiles } = parseArgs(runtimeArgs);
+  let demoPreparation = null;
   kittyImageMode = flags.kittyMode;
   allowRemoteKittyImages = flags.allowUrl;
 
@@ -8096,7 +8368,7 @@ async function main() {
   if (flags.version) {
     const ttsCmd = detectTtsCmd();
     console.log(pkg.name+":",pkg.description)
-    console.log("  Rewritten by: Dr. John (醫者小智)")
+    console.log("  Made by: Dr. John (醫者小智)")
     console.log("")
     console.log("Version:", VERSION);
     console.log("Runtime:", `Bun ${Bun.version}`);
@@ -8104,6 +8376,19 @@ async function main() {
     console.log("Http client:",detectHttpBackend());
     console.log("TTS:", ttsCmd ? ttsCmd.cmd[0] : "not found");
     console.log({SUPPORTED_ENCODING_LABELS})
+    console.log("Distribution settings:");
+    console.log("  MDCUI_DEFAULT_EDIT:", (MDCUI_DEFAULT_EDIT_ENABLED || defaultEdit) ? "enabled" : "disabled");
+    console.log("  MDCUI_DEFAULT_DEMO:", MDCUI_DEFAULT_DEMO_ENABLED ? "enabled" : "disabled");
+    console.log("  MDCUI_DEFAULT_DEMO_WUI:", MDCUI_DEFAULT_DEMO_WUI_ENABLED ? "enabled" : "disabled");
+    console.log("  MDCUI_OVERWRITE_DEMO:", MDCUI_OVERWRITE_DEMO_ENABLED ? "enabled" : "disabled");
+    console.log(
+      "  global.MDCUI_MAIN:",
+      String(global.MDCUI_MAIN || "") || "not set",
+    );
+    console.log(
+      "  global.MDCUI_MAIN_BASE:",
+      String(global.MDCUI_MAIN_BASE || "") || "not set",
+    );
     const clipboard = new ClipboardManager();
     let osc52Available = false;
     if (process.stdin.isTTY && process.stdout.isTTY) {
@@ -8118,6 +8403,18 @@ async function main() {
     console.log("Clipboard:", backends);
     return;
   }
+  if (flags.wui) {
+    demoPreparation = await prepareDemo(flags, rawFiles);
+    if (!demoPreparation.ok) return;
+    const runmd = await import("../runmd.mjs");
+    await runmd.main(30, {
+      mdpath: rawFiles[0] ?? null,
+      overwriteDemo: flags.overwriteDemo && rawFiles.length === 0,
+      printUi: flags.printUi,
+      useBundledMdcuiServer: demoPreparation.useBundledModules,
+    });
+    return;
+  }
   if (flags.check) {
     if (rawFiles.length !== 1) {
       console.error("Usage: jsmdcui --check FILE.md");
@@ -8162,24 +8459,8 @@ async function main() {
     return;
   }
   if (flags.demo) {
-    if (flags.demo.error) {
-      console.error(`Invalid demo option ${flags.demo.option}: ${flags.demo.error}`);
-      process.exitCode = 2;
-      return;
-    }
-    let demoSource;
-    try {
-      demoSource = await bundledMarkdownSource(flags.demo.asset);
-    } catch {
-      console.error(`Unknown demo ${flags.demo.option}: ${flags.demo.asset} was not found`);
-      process.exitCode = 2;
-      return;
-    }
-    const demoPath = resolve(flags.demo.filename);
-    if (!(await Bun.file(demoPath).exists())) {
-      await Bun.write(demoPath, demoSource);
-    }
-    rawFiles.splice(0, rawFiles.length, demoPath);
+    demoPreparation = await prepareDemo(flags, rawFiles);
+    if (!demoPreparation.ok) return;
   }
   if (flags.options) {
     for (const [key, value] of Object.entries(defaultAllSettings()).sort(([a], [b]) => a.localeCompare(b))) {
@@ -8192,6 +8473,7 @@ async function main() {
   const config = await new Config({ configDir: flags.configDir }).init();
   config.applyCliSettings(flags.settings);
   const encodingExplicit = flags.settings.has("encoding") || Object.hasOwn(config.parsedSettings, "encoding");
+  const inputFiletype = flags.settings.has("filetype") ? String(flags.settings.get("filetype")) : null;
   syncEditorSettings(config);
 
   addCheckpoint("Runtime Registry Init");
@@ -8203,7 +8485,14 @@ async function main() {
   const syntaxDefinitions = await loadSyntaxDefinitions(runtime);
 
   if (flags.cat) {
-    await catFiles(rawFiles, colorscheme, syntaxDefinitions, config.getGlobalOption("encoding"), !encodingExplicit);
+    await catFiles(
+      rawFiles,
+      colorscheme,
+      syntaxDefinitions,
+      config.getGlobalOption("encoding"),
+      !encodingExplicit,
+      inputFiletype,
+    );
     return;
   }
 
@@ -8268,6 +8557,7 @@ async function main() {
     runtime,
     jsPlugins,
     encodingExplicit,
+    inputFiletype,
     allowUrl: flags.allowUrl,
     kittyMode: flags.kittyMode,
   };
@@ -8318,6 +8608,16 @@ async function main() {
     const buffers = await loadBuffers(files.map((file) =>
       isHttpUrl(file) ? file : resolve(file)
     ), command);
+    if (demoPreparation?.useBundledModules) {
+      const bundledDemoBuffer = buffers.find((buffer) =>
+        buffer.path
+        && !isHttpUrl(buffer.path)
+        && resolve(buffer.path) === demoPreparation.path
+      );
+      if (bundledDemoBuffer) {
+        bundledDemoBuffer._useBundledMdcuiModules = true;
+      }
+    }
 
     let historyPromise = Promise.resolve();
     if (config.getGlobalOption("savehistory") !== false) {
@@ -8725,9 +9025,12 @@ function getSelectionText(buf, selection) {
 
 function attachSyntax(buffer, context, path, text) {
   buffer._syntaxContext = context;
-  const def = detectBufferSyntax(context.syntaxDefinitions, path, text);
+  const explicitFiletype = context.inputFiletype;
+  const def = explicitFiletype == null
+    ? detectBufferSyntax(context.syntaxDefinitions, path, text)
+    : context.syntaxDefinitions?.find((candidate) => candidate.filetype === explicitFiletype) ?? null;
   buffer.syntaxDefinition = def;
-  buffer.filetype = def?.filetype ?? "unknown";
+  buffer.filetype = explicitFiletype == null ? (def?.filetype ?? "unknown") : String(explicitFiletype);
   buffer.Settings.filetype = buffer.filetype;
   buffer.highlighter = def ? new Highlighter(def, context.syntaxDefinitions ?? []) : null;
   buffer._highlightCache = null;
@@ -8805,7 +9108,7 @@ function syncEditorSettings(config) {
   }
 }
 
-async function catFiles(files, colorscheme, syntaxDefinitions, encoding = DEFAULT_SETTINGS.encoding, inferMdcui = true) {
+async function catFiles(files, colorscheme, syntaxDefinitions, encoding = DEFAULT_SETTINGS.encoding, inferMdcui = true, filetype = null) {
   const targets = files.length > 0 ? files.map((f) => ({ path: f, stdin: false })) : [{ path: null, stdin: true }];
   for (const { path: filePath, stdin } of targets) {
     let content;
@@ -8836,7 +9139,7 @@ async function catFiles(files, colorscheme, syntaxDefinitions, encoding = DEFAUL
       process.stdout.write(ansiContent ?? content);
       if (!(ansiContent ?? content).endsWith("\n")) process.stdout.write("\n");
       continue;
-    } else if (effectivePath && /\.md$/i.test(effectivePath)) {
+    } else if (filetype == null && effectivePath && /\.md$/i.test(effectivePath)) {
       process.stdout.write(
         Bun.markdown.ansi(content,{
           hyperlinks:true
@@ -8845,11 +9148,13 @@ async function catFiles(files, colorscheme, syntaxDefinitions, encoding = DEFAUL
       continue;
     }
     const lines = normalizeBufferText(content).split("\n");
-    const def = detectSyntax(syntaxDefinitions, {
-      path: effectivePath ?? "",
-      firstLine: lines[0] ?? "",
-      lines: lines.slice(0, 50),
-    });
+    const def = filetype == null
+      ? detectSyntax(syntaxDefinitions, {
+          path: effectivePath ?? "",
+          firstLine: lines[0] ?? "",
+          lines: lines.slice(0, 50),
+        })
+      : syntaxDefinitions.find((candidate) => candidate.filetype === filetype) ?? null;
     const highlighter = def ? new Highlighter(def, syntaxDefinitions) : null;
     if (!highlighter) {
       process.stdout.write(content);