md4x 0.0.2 → 0.0.4

package/lib/cli.mjs

@@ -22,26 +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
-
-Input can be a file path, "-" for stdin, an HTTP/HTTPS URL, or a shorthand:
-  gh:<owner>/<repo>[/path]   GitHub (auto-converted to raw content)
-  npm:<package>[@version][/path]  npm package file via unpkg
-
-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")}
 `,
   );
 }

package/lib/napi.d.mts

@@ -3,5 +3,6 @@ import type { ComarkTree } from "./types.js";
 export type { ComarkTree, ComarkNode, ComarkElement, ComarkText, ComarkElementAttributes } from "./types.js";
 
 export declare function renderToHtml(input: string): string;
-export declare function renderToJson(input: string): ComarkTree;
+export declare function renderToJson(input: string): string;
+export declare function parseAST(input: string): ComarkTree;
 export declare function renderToAnsi(input: string): string;

package/lib/napi.mjs

@@ -19,7 +19,11 @@ export function renderToHtml(input) {
 }
 
 export function renderToJson(input) {
-  return JSON.parse(binding.renderToJson(input));
+  return binding.renderToJson(input);
+}
+
+export function parseAST(input) {
+  return JSON.parse(renderToJson(input));
 }
 
 export function renderToAnsi(input) {

package/lib/wasm.d.mts

@@ -4,5 +4,6 @@ export type { ComarkTree, ComarkNode, ComarkElement, ComarkText, ComarkElementAt
 
 export declare function initWasm(input?: ArrayBuffer | Uint8Array | WebAssembly.Module | Response | Promise<Response>): Promise<void>;
 export declare function renderToHtml(input: string): string;
-export declare function renderToJson(input: string): ComarkTree;
+export declare function renderToJson(input: string): string;
+export declare function parseAST(input: string): ComarkTree;
 export declare function renderToAnsi(input: string): string;

package/lib/wasm.mjs

@@ -45,7 +45,11 @@ export function renderToHtml(input) {
 }
 
 export function renderToJson(input) {
-  return JSON.parse(render(getExports(), getExports().md4x_to_json, input));
+  return render(getExports(), getExports().md4x_to_json, input);
+}
+
+export function parseAST(input) {
+  return JSON.parse(renderToJson(input));
 }
 
 export function renderToAnsi(input) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "md4x",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "license": "MIT",
   "type": "module",
   "bin": {