@markdy/cli 0.7.18 → 0.7.20

package/README.md

@@ -8,6 +8,27 @@ First-party command-line tooling for MarkdyScript.
 npm i -D @markdy/cli
 ```
 
+If you install it into a project, run it with `npx markdy ...` or `npm exec markdy ...` from that project.
+To make `markdy` available as a shell command everywhere, install it globally with `npm i -g @markdy/cli`.
+
+## Visual guide
+
+<p align="center">
+	<img src="https://raw.githubusercontent.com/HoangYell/markdy-com/main/website/public/images/markdy-cli-flow.webp" alt="Markdy CLI workflow visual" width="900" />
+</p>
+
+## Love Story result
+
+<p align="center">
+	<img src="https://raw.githubusercontent.com/HoangYell/markdy-com/main/website/public/images/markdy-love-story-result.webp" alt="Love Story main Markdy result" width="900" />
+</p>
+
+Use the same command shown in this repo to generate the preview image yourself:
+
+```bash
+npx markdy render examples/00-love-story.markdy --out examples/xscene.html
+```
+
 ## Commands
 
 ```bash
@@ -27,4 +48,6 @@ markdy check-all .
 
 - The CLI resolves `import "file.markdy" as ns` from disk before parsing.
 - `fmt` prints a canonicalized scene and may expand higher-level sugar into its parsed form.
-- `render --out` writes a self-contained HTML preview you can open in a browser.
+- `render --out` writes a self-contained HTML preview to the exact path you pass in.
+- If the path is relative, it is resolved from the current working directory.
+- If you see `zsh: command not found: markdy`, the package is installed locally but that directory is not on your PATH.

package/dist/index.js

@@ -3,7 +3,7 @@
 // src/index.ts
 import { PRESETS, PRESET_NAMES, parse } from "@markdy/core";
 import { createRequire } from "module";
-import { basename, dirname, extname, join, resolve } from "path";
+import { basename, dirname, extname, join, resolve, sep } from "path";
 import { fileURLToPath, pathToFileURL } from "url";
 import { createServer } from "http";
 import { readdir, readFile, stat, writeFile } from "fs/promises";
@@ -157,7 +157,7 @@ var MARKDY_EXT = ".markdy";
 var PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 async function runCli(argv, io = defaultIo(), runtime = defaultRuntime()) {
   const parsed = parseArgv(argv);
-  if (!parsed.command && hasFlag(parsed, "help")) {
+  if (hasFlag(parsed, "help")) {
     io.stdout(helpText());
     return { exitCode: 0 };
   }
@@ -165,10 +165,6 @@ async function runCli(argv, io = defaultIo(), runtime = defaultRuntime()) {
     return launchPlayground(parsed, io, runtime);
   }
   const command = parsed.command;
-  if (command === "--help" || command === "-h") {
-    io.stdout(helpText());
-    return { exitCode: 0 };
-  }
   switch (command) {
     case "lint":
       return lintCommand(parsed, io);
@@ -454,7 +450,7 @@ async function startPreviewServer(code, imports, sourcePath, preferredPort) {
 async function servePackageFile(response, distDir, relativePath) {
   const safePath = relativePath.replace(/^\/+/, "");
   const fullPath = resolve(distDir, safePath);
-  if (!fullPath.startsWith(distDir)) {
+  if (fullPath !== distDir && !fullPath.startsWith(distDir + sep)) {
     sendText(response, 403, "Forbidden", "text/plain; charset=utf-8");
     return;
   }
@@ -771,11 +767,13 @@ function parseArgv(argv) {
       continue;
     }
     if (arg.startsWith("--")) {
-      const [rawKey, rawValue] = arg.slice(2).split("=", 2);
-      if (rawValue !== void 0) {
-        flags.set(rawKey, rawValue);
+      const body = arg.slice(2);
+      const eqIndex = body.indexOf("=");
+      if (eqIndex !== -1) {
+        flags.set(body.slice(0, eqIndex), body.slice(eqIndex + 1));
         continue;
       }
+      const rawKey = body;
       const next = argv[index + 1];
       if (next && !next.startsWith("-") && expectsValue(rawKey)) {
         flags.set(rawKey, next);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markdy/cli",
-  "version": "0.7.18",
+  "version": "0.7.20",
   "description": "First-party CLI for MarkdyScript: lint, format, explain, render, and local playground tooling.",
   "license": "MIT",
   "type": "module",
@@ -41,8 +41,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@markdy/core": "0.7.18",
-    "@markdy/renderer-dom": "0.7.18"
+    "@markdy/core": "0.7.20",
+    "@markdy/renderer-dom": "0.7.20"
   },
   "devDependencies": {
     "@types/node": "^25.9.5",