md4x 0.0.1 → 0.0.3

package/lib/cli.mjs

@@ -22,22 +22,44 @@ const { values, positionals } = parseArgs({
   },
 });
 
+const _tty = process.stderr.isTTY;
+const c = (code) => (s) => _tty ? `\x1b[${code}m${s}\x1b[0m` : s;
+const _b = c(1);
+const _d = c(2);
+const _c = c(36);
+const _g = c(32);
+
 function usage() {
   process.stderr.write(
-    `Usage: md4x [OPTION]... [FILE]
-Convert input FILE (or standard input) in Markdown format.
-
-General options:
-  -o  --output=FILE    Output file (default is standard output)
-  -t, --format=FORMAT  Output format: html, json, ansi (default: ansi for TTY, html otherwise)
-  -s, --stat           Measure time of input parsing
-  -h, --help           Display this help and exit
-  -v, --version        Display version and exit
-
-HTML output options:
-  -f, --full-html      Generate full HTML document, including header
-      --html-title=TITLE Sets the title of the document
-      --html-css=URL   In full HTML mode add a css link
+    `${_b("md4x")} — Markdown renderer
+
+${_g("Usage:")} ${_b("md4x")} ${_d("[OPTION]... [FILE]")}
+
+${_g("General options:")}
+  ${_c("-o")}, ${_c("--output")}=${_d("FILE")}     Output file ${_d("(default: stdout)")}
+  ${_c("-t")}, ${_c("--format")}=${_d("FORMAT")}   Output format: html, json, ansi ${_d("(default: ansi for TTY, html otherwise)")}
+  ${_c("-s")}, ${_c("--stat")}            Measure parsing time
+  ${_c("-h")}, ${_c("--help")}            Display this help and exit
+  ${_c("-v")}, ${_c("--version")}         Display version and exit
+
+${_g("Input:")}
+  File path, ${_c("-")} for stdin, HTTP/HTTPS URL, or shorthand:
+  ${_c("gh:")}${_d("<owner>/<repo>[/path]")}          GitHub raw content
+  ${_c("npm:")}${_d("<package>[@version][/path]")}    npm package via unpkg
+
+${_g("HTML options:")}
+      ${_c("-f")}, ${_c("--full-html")}     Full HTML document with header
+      ${_c("--html-title")}=${_d("TITLE")}  Document title
+      ${_c("--html-css")}=${_d("URL")}      CSS link
+
+${_g("Examples:")}
+  ${_d("$")} ${_b("md4x")} README.md                        ${_d("# Render to terminal")}
+  ${_d("$")} ${_b("md4x")} ${_c("-t html")} doc.md                   ${_d("# HTML output")}
+  ${_d("$")} ${_b("md4x")} ${_c("-t json")} doc.md                   ${_d("# JSON AST output")}
+  ${_d("$")} ${_b("md4x")} ${_c("gh:")}pi0/md4x                      ${_d("# GitHub repo README")}
+  ${_d("$")} ${_b("md4x")} ${_c("npm:")}vue@3                        ${_d("# npm package README")}
+  ${_d("$")} echo "# Hello" | ${_b("md4x")}                 ${_d("# Pipe from stdin")}
+  ${_d("$")} ${_b("md4x")} ${_c("-f --html-css")}=style.css doc.md   ${_d("# Full HTML with CSS")}
 `,
   );
 }
@@ -62,7 +84,23 @@ if (!["html", "json", "ansi"].includes(format)) {
   process.exit(1);
 }
 
-const inputPath = positionals[0];
+let inputPath = positionals[0];
+// gh:owner/repo[/path] → https://github.com/owner/repo[/path]
+if (inputPath && /^gh:/i.test(inputPath)) {
+  inputPath = `https://github.com/${inputPath.slice(3)}`;
+}
+// npm:package[@version][/path] → https://unpkg.com/package[@version][/path]
+if (inputPath && /^npm:/i.test(inputPath)) {
+  const spec = inputPath.slice(4);
+  // Check if spec includes a file path (after the package name + optional version)
+  // Scoped: @scope/pkg[@ver][/path] — path starts after 2nd slash
+  // Unscoped: pkg[@ver][/path] — path starts after 1st slash
+  const slashIdx = spec.startsWith("@")
+    ? spec.indexOf("/", spec.indexOf("/") + 1)
+    : spec.indexOf("/");
+  const hasPath = slashIdx > 0;
+  inputPath = `https://unpkg.com/${spec}${hasPath ? "" : "/README.md"}`;
+}
 let input;
 if (!inputPath || inputPath === "-") {
   if (process.stdin.isTTY) {
@@ -75,6 +113,23 @@ if (!inputPath || inputPath === "-") {
     usage();
     process.exit(1);
   }
+} else if (/^https?:\/\//i.test(inputPath)) {
+  const fetchUrl = toRawUrl(inputPath);
+  try {
+    const res = await fetch(fetchUrl, {
+      headers: { Accept: "text/markdown, text/plain;q=0.9, */*;q=0.1" },
+    });
+    if (!res.ok) {
+      process.stderr.write(
+        `Failed to fetch ${inputPath}: ${res.status} ${res.statusText}\n`,
+      );
+      process.exit(1);
+    }
+    input = await res.text();
+  } catch (err) {
+    process.stderr.write(`Failed to fetch ${inputPath}: ${err.message}\n`);
+    process.exit(1);
+  }
 } else {
   try {
     input = readFileSync(inputPath, "utf8");
@@ -136,3 +191,27 @@ if (values.output && values.output !== "-") {
 } else {
   process.stdout.write(result);
 }
+
+// --- internal helpers ---
+
+/** Convert GitHub web URLs to raw content URLs */
+function toRawUrl(url) {
+  const u = new URL(url);
+  if (u.hostname === "github.com" || u.hostname === "www.github.com") {
+    // github.com/:owner/:repo/blob/:ref/path → raw.githubusercontent.com/:owner/:repo/:ref/path
+    const blob = u.pathname.match(/^\/([^/]+\/[^/]+)\/blob\/(.+)/);
+    if (blob) {
+      return `https://raw.githubusercontent.com/${blob[1]}/${blob[2]}`;
+    }
+    // github.com/:owner/:repo → raw.githubusercontent.com/:owner/:repo/HEAD/README.md
+    const repo = u.pathname.match(/^\/([^/]+\/[^/]+)\/?$/);
+    if (repo) {
+      return `https://raw.githubusercontent.com/${repo[1]}/HEAD/README.md`;
+    }
+  }
+  // gist.github.com/:user/:id → gist.githubusercontent.com/:user/:id/raw
+  if (u.hostname === "gist.github.com") {
+    return `https://gist.githubusercontent.com${u.pathname}/raw`;
+  }
+  return url;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "md4x",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "license": "MIT",
   "type": "module",
   "bin": {
@@ -23,7 +23,8 @@
   },
   "files": [
     "build",
-    "lib"
+    "lib",
+    "README.md"
   ],
   "devDependencies": {
     "@milkdown/crepe": "^7.18.0",