jsmdcui 0.11.1 → 0.11.2

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable user-visible changes to jsmdcui are documented here.
 
+## [0.11.2] - 2026-07-26
+
+### Added
+
+- Add `--build-md-exe <file.md>` as a convenience alias for building a
+  current-platform executable with `global.MDCUI_MAIN` set to the specified
+  Markdown app.
+- Add `--build-md-for <platform> <file.md>` for the equivalent
+  cross-compilation workflow. Both aliases expand into the existing build
+  arguments before generated application files are written.
+
+### Fixed
+
+- Fix the final executable existence check for Windows builds by checking the
+  `.exe` output path for Windows targets, or for native Windows builds when no
+  target is specified.
+
 ## [0.11.1] - 2026-07-26
 
 ### Changed

package/README.md

@@ -775,6 +775,25 @@ use `=1` to make this explicit.
 - `global.MDCUI_MAIN_BASE`: internal define generated automatically from
   `global.MDCUI_MAIN`; do not pass it manually.
 
+For the current platform, build an executable embedding `myapp.md` with:
+
+```shell
+npx jsmdcui --build-md-exe myapp.md
+```
+
+This is a convenience alias for
+`--build-exe --define global.MDCUI_MAIN=myapp.md`.
+
+For cross-compilation, specify the Bun target before the Markdown file:
+
+```shell
+npx jsmdcui --build-md-for bun-linux-x64-v1.3.14 myapp.md
+```
+
+This similarly expands to
+`--build-for bun-linux-x64 --define global.MDCUI_MAIN=myapp.md`. Both aliases
+are expanded before any generated application files are written.
+
 Place every build define after `--build-exe`, or after the target argument of
 `--build-for`. Choose at most one of `MDCUI_DEFAULT_EDIT`,
 `MDCUI_DEFAULT_DEMO`, and `MDCUI_DEFAULT_DEMO_WUI`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsmdcui",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "Markdown as a Common UI for Terminals and Web Browsers",
   "type": "module",
   "main": "./src/index.js",

package/runtime/help/help.md

@@ -775,6 +775,25 @@ use `=1` to make this explicit.
 - `global.MDCUI_MAIN_BASE`: internal define generated automatically from
   `global.MDCUI_MAIN`; do not pass it manually.
 
+For the current platform, build an executable embedding `myapp.md` with:
+
+```shell
+npx jsmdcui --build-md-exe myapp.md
+```
+
+This is a convenience alias for
+`--build-exe --define global.MDCUI_MAIN=myapp.md`.
+
+For cross-compilation, specify the Bun target before the Markdown file:
+
+```shell
+npx jsmdcui --build-md-for bun-linux-x64-v1.3.14 myapp.md
+```
+
+This similarly expands to
+`--build-for bun-linux-x64 --define global.MDCUI_MAIN=myapp.md`. Both aliases
+are expanded before any generated application files are written.
+
 Place every build define after `--build-exe`, or after the target argument of
 `--build-for`. Choose at most one of `MDCUI_DEFAULT_EDIT`,
 `MDCUI_DEFAULT_DEMO`, and `MDCUI_DEFAULT_DEMO_WUI`.

package/single-exe/compiled.js

@@ -92,7 +92,7 @@ export function stringifyNonPrimitiveDefineValues(argv, name) {
 
 export async function buildExecutable(target = "",build_outfile="single.exe", bunArgs = []) {
  
-  const outfile = resolve(process.cwd(), build_outfile);
+  let outfile = resolve(process.cwd(), build_outfile);
   const normalizedTarget = String(target || "").trim();
   const extraBunArgs = Array.from(bunArgs ?? [], String);
   if(!globalThis.Bun || IS_COMPILED)
@@ -164,6 +164,12 @@ export async function buildExecutable(target = "",build_outfile="single.exe", bu
     
   }  //  for steps of build
 
+  const isWindows = normalizedTarget
+    ? normalizedTarget.toLowerCase().includes("windows")
+    : process.platform === "win32";
+  if (isWindows && !outfile.toLowerCase().endsWith(".exe")) {
+    outfile += ".exe";
+  }
   if(await Bun.file(outfile).exists())
   {
     console.log(`Built executable: ${outfile}`);

package/src/build-args.js

@@ -0,0 +1,40 @@
+export function expandBuildMdAliases(argv = process.argv) {
+  const buildMdExeIndex = argv.indexOf("--build-md-exe");
+  if (buildMdExeIndex !== -1) {
+    const markdown = argv[buildMdExeIndex + 1];
+    if (!markdown || markdown.startsWith("-")) {
+      throw new Error("Missing Markdown path for --build-md-exe");
+    }
+
+    argv.splice(
+      buildMdExeIndex,
+      2,
+      "--build-exe",
+      "--define",
+      `global.MDCUI_MAIN=${markdown}`,
+    );
+    return true;
+  }
+
+  const buildMdForIndex = argv.indexOf("--build-md-for");
+  if (buildMdForIndex === -1) return false;
+
+  const platform = argv[buildMdForIndex + 1];
+  if (!platform || platform.startsWith("-")) {
+    throw new Error("Missing platform for --build-md-for");
+  }
+  const markdown = argv[buildMdForIndex + 2];
+  if (!markdown || markdown.startsWith("-")) {
+    throw new Error("Missing Markdown path for --build-md-for");
+  }
+
+  argv.splice(
+    buildMdForIndex,
+    3,
+    "--build-for",
+    platform,
+    "--define",
+    `global.MDCUI_MAIN=${markdown}`,
+  );
+  return true;
+}

package/src/index.js

@@ -129,6 +129,7 @@ import { createInterface } from "node:readline/promises";
 
 import pkg from "../package.json" with { type: "json" };
 import { REPO_ROOT,IS_COMPILED, buildExecutable,buildEarlyExit,stringifyNonPrimitiveDefineValues } from "../single-exe/compiled.js";
+import { expandBuildMdAliases } from "./build-args.js";
 
 
 const __filename = fileURLToPath(import.meta.url);
@@ -1349,14 +1350,20 @@ Remote Markdown:
       Download HTTP(S) Markdown and, with Kitty mode, its HTTP(S) images; allow its code to run
 
 Experimental single-exe:
+  --build-md-exe <file.md> [BUN_ARGS...]
+      Build with <file.md> embedded as global.MDCUI_MAIN & exit
+  --build-md-for <platform> <file.md> [BUN_ARGS...]
+      Build for <platform> with <file.md> embedded & exit
+      
   --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
+      --define MDCUI_OVERWRITE_DEMO=1 
+      --define global.MDCUI_MAIN=myapp.md
+      More info in --readme
       https://bun.com/docs/bundler/executables
 `
   ].join("\n");
@@ -5024,7 +5031,7 @@ class App {
         const name = buf?.name ?? "No name";
         const filename = /^[^\s"'\\]+$/.test(name) ? name : JSON.stringify(name);
         this.openCommandMode(`save ${filename}`);
-        break;
+        break; //"
       }
       case "row":
         if (isTerm) {
@@ -8257,6 +8264,7 @@ function stringDefineFromArgv(argv, name) {
 async function main() {
   addCheckpoint("Argument Parsing");
 
+  expandBuildMdAliases(process.argv);
   stringifyNonPrimitiveDefineValues(process.argv, "global.MDCUI_MAIN");
   const argvMdcuiMain = stringDefineFromArgv(
     process.argv,

package/tests/compiled-runtime.test.js

@@ -1,4 +1,5 @@
 import { expect, test } from "bun:test";
+import { expandBuildMdAliases } from "../src/build-args.js";
 import {
   isCompiledBinary as isSingleExeCompiled,
   stringifyNonPrimitiveDefineValues,
@@ -10,6 +11,69 @@ test("single-exe recognizes Bun compiled virtual paths", () => {
   expect(isSingleExeCompiled(["bun", "/project/src/index.js"])).toBe(false);
 });
 
+test("--build-md-exe expands before the existing build flow", () => {
+  const argv = [
+    "bun",
+    "src/index.js",
+    "--build-md-exe",
+    "../中文工具.md",
+    "--sourcemap",
+  ];
+  expect(expandBuildMdAliases(argv)).toBe(true);
+  expect(argv).toEqual([
+    "bun",
+    "src/index.js",
+    "--build-exe",
+    "--define",
+    "global.MDCUI_MAIN=../中文工具.md",
+    "--sourcemap",
+  ]);
+  expect(expandBuildMdAliases(argv)).toBe(false);
+});
+
+test("--build-md-exe requires a Markdown path", () => {
+  expect(() => expandBuildMdAliases(["bun", "index.js", "--build-md-exe"]))
+    .toThrow("Missing Markdown path for --build-md-exe");
+  expect(() => expandBuildMdAliases([
+    "bun",
+    "index.js",
+    "--build-md-exe",
+    "--sourcemap",
+  ])).toThrow("Missing Markdown path for --build-md-exe");
+});
+
+test("--build-md-for expands before the existing cross-build flow", () => {
+  const argv = [
+    "bun",
+    "src/index.js",
+    "--build-md-for",
+    "bun-linux-x64",
+    "../中文工具.md",
+    "--sourcemap",
+  ];
+  expect(expandBuildMdAliases(argv)).toBe(true);
+  expect(argv).toEqual([
+    "bun",
+    "src/index.js",
+    "--build-for",
+    "bun-linux-x64",
+    "--define",
+    "global.MDCUI_MAIN=../中文工具.md",
+    "--sourcemap",
+  ]);
+});
+
+test("--build-md-for requires a platform and Markdown path", () => {
+  expect(() => expandBuildMdAliases(["bun", "index.js", "--build-md-for"]))
+    .toThrow("Missing platform for --build-md-for");
+  expect(() => expandBuildMdAliases([
+    "bun",
+    "index.js",
+    "--build-md-for",
+    "bun-linux-x64",
+  ])).toThrow("Missing Markdown path for --build-md-for");
+});
+
 test("non-primitive MDCUI_MAIN define values become strings", () => {
   const split = [
     "bun",