@headwall/markdown-to-blocks 1.2.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli.js CHANGED
@@ -2,9 +2,11 @@
2
2
  import { createRequire as __md2b_cr } from 'module';
3
3
  const require = __md2b_cr(import.meta.url);
4
4
  import {
5
+ applyOptionDefaults,
5
6
  markdownToBlocks,
6
- parseMarkdownDocument
7
- } from "./chunk-CHMDS2SX.js";
7
+ parseMarkdownDocument,
8
+ validateOptions
9
+ } from "./chunk-26IEHNWU.js";
8
10
 
9
11
  // src/cli.ts
10
12
  import { readFileSync, writeFileSync } from "fs";
@@ -20,50 +22,78 @@ Options:
20
22
  -o, --output <file> Output file (default: stdout)
21
23
  --frontmatter Emit JSON { frontmatter, blocks } instead of markup
22
24
  --heading-shift <n> Shift all heading levels by n (default 0)
23
- --min-heading-level <n> Clamp heading levels to [n, 6] (default 2)
25
+ --min-heading-level <n> Clamp heading levels to [n, 6], n from 1 to 6 (default 2)
24
26
  --heading-anchors Add an id/anchor to each heading from its text
25
27
  --code-language <mode> 'drop' (default) or 'class' (emit language-xxx)
26
- --unsupported <mode> 'html' (default) or 'skip'
28
+ --unsupported <mode> 'html' (default) or 'skip' (drop block and inline HTML)
29
+ --url-schemes <mode> 'safe' (default: http(s)/mailto/tel/relative) or 'any'
27
30
  --no-gfm Disable GFM (tables, strikethrough, autolinks)
28
31
  -h, --help Show this help
29
32
  -v, --version Show version
30
33
  `;
34
+ function parseIntegerFlag(flag, value, errors) {
35
+ let parsed;
36
+ if (value != null) {
37
+ const candidate = value.trim() === "" ? Number.NaN : Number(value);
38
+ if (Number.isInteger(candidate)) {
39
+ parsed = candidate;
40
+ } else {
41
+ errors.push(`${flag} expects an integer (got ${JSON.stringify(value)})`);
42
+ }
43
+ }
44
+ return parsed;
45
+ }
31
46
  function parseArgs(argv) {
32
47
  const args = {
33
48
  frontmatter: false,
34
49
  help: false,
35
50
  version: false,
36
- options: {}
51
+ options: {},
52
+ errors: []
37
53
  };
38
- let positional;
39
- for (let i = 0; i < argv.length; i++) {
40
- const arg = argv[i];
54
+ const positionals = [];
55
+ let index = 0;
56
+ while (index < argv.length) {
57
+ const arg = argv[index] ?? "";
58
+ index += 1;
59
+ const takeValue = () => {
60
+ const value = argv[index];
61
+ if (value == null) {
62
+ args.errors.push(`${arg} requires a value`);
63
+ } else {
64
+ index += 1;
65
+ }
66
+ return value;
67
+ };
41
68
  switch (arg) {
42
69
  case "-i":
43
70
  case "--input":
44
- args.input = argv[++i];
71
+ args.input = takeValue();
45
72
  break;
46
73
  case "-o":
47
74
  case "--output":
48
- args.output = argv[++i];
75
+ args.output = takeValue();
49
76
  break;
50
77
  case "--frontmatter":
51
78
  args.frontmatter = true;
52
79
  break;
53
80
  case "--heading-shift":
54
- args.options.headingShift = Number(argv[++i]);
81
+ args.options.headingShift = parseIntegerFlag(arg, takeValue(), args.errors);
55
82
  break;
56
83
  case "--min-heading-level":
57
- args.options.minHeadingLevel = Number(argv[++i]);
84
+ args.options.minHeadingLevel = parseIntegerFlag(arg, takeValue(), args.errors);
58
85
  break;
59
86
  case "--heading-anchors":
60
87
  args.options.headingAnchors = true;
61
88
  break;
62
89
  case "--code-language":
63
- args.options.codeLanguage = argv[++i];
90
+ args.options.codeLanguage = takeValue();
64
91
  break;
65
92
  case "--unsupported":
66
- args.options.unsupported = argv[++i];
93
+ args.options.unsupported = takeValue();
94
+ break;
95
+ case "--url-schemes":
96
+ args.options.urlSchemes = takeValue();
67
97
  break;
68
98
  case "--no-gfm":
69
99
  args.options.gfm = false;
@@ -77,15 +107,24 @@ function parseArgs(argv) {
77
107
  args.version = true;
78
108
  break;
79
109
  default:
80
- if (arg != null && !arg.startsWith("-") && positional == null) {
81
- positional = arg;
110
+ if (arg.startsWith("-") && arg !== "-") {
111
+ args.errors.push(`unknown option ${arg}`);
112
+ } else {
113
+ positionals.push(arg);
82
114
  }
83
115
  break;
84
116
  }
85
117
  }
86
- if (args.input == null && positional != null) {
118
+ const [positional, ...extra] = positionals;
119
+ if (positional != null && args.input == null) {
87
120
  args.input = positional;
121
+ } else if (positional != null) {
122
+ extra.unshift(positional);
88
123
  }
124
+ for (const unexpected of extra) {
125
+ args.errors.push(`unexpected argument ${JSON.stringify(unexpected)}`);
126
+ }
127
+ args.errors.push(...validateOptions(applyOptionDefaults(args.options)));
89
128
  return args;
90
129
  }
91
130
  function readInput(input) {
@@ -99,10 +138,18 @@ function run(argv) {
99
138
  return 0;
100
139
  }
101
140
  if (args.version) {
102
- process.stdout.write(`${"1.2.0"}
141
+ process.stdout.write(`${"1.4.0"}
103
142
  `);
104
143
  return 0;
105
144
  }
145
+ if (args.errors.length > 0) {
146
+ for (const error of args.errors) {
147
+ process.stderr.write(`md2blocks: ${error}
148
+ `);
149
+ }
150
+ process.stderr.write("Run md2blocks --help for usage.\n");
151
+ return 1;
152
+ }
106
153
  const wantsStdin = args.input == null || args.input === "-";
107
154
  if (wantsStdin && process.stdin.isTTY) {
108
155
  process.stderr.write(
@@ -122,12 +169,24 @@ function run(argv) {
122
169
  }
123
170
  return 0;
124
171
  }
125
- try {
126
- process.exit(run(process.argv.slice(2)));
127
- } catch (error) {
172
+ var EXIT_BROKEN_PIPE = 141;
173
+ function reportError(error) {
128
174
  const message = error instanceof Error ? error.message : String(error);
129
175
  process.stderr.write(`md2blocks: ${message}
130
176
  `);
131
- process.exit(1);
177
+ }
178
+ process.stdout.on("error", (error) => {
179
+ if (error.code === "EPIPE") {
180
+ process.exit(EXIT_BROKEN_PIPE);
181
+ } else {
182
+ reportError(error);
183
+ process.exit(1);
184
+ }
185
+ });
186
+ try {
187
+ process.exitCode = run(process.argv.slice(2));
188
+ } catch (error) {
189
+ reportError(error);
190
+ process.exitCode = 1;
132
191
  }
133
192
  //# sourceMappingURL=cli.js.map
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync, writeFileSync } from \"node:fs\";\nimport { markdownToBlocks } from \"./convert.js\";\nimport { parseMarkdownDocument } from \"./document.js\";\nimport type { ConvertOptions } from \"./types.js\";\n\nconst HELP = `md2blocks — convert Markdown to WordPress/Gutenberg block markup\n\nUsage:\n md2blocks -i <file.md> [-o <out.html>]\n md2blocks <file.md>\n cat doc.md | md2blocks -\n\nOptions:\n -i, --input <file> Input Markdown file (use \"-\" or omit for stdin)\n -o, --output <file> Output file (default: stdout)\n --frontmatter Emit JSON { frontmatter, blocks } instead of markup\n --heading-shift <n> Shift all heading levels by n (default 0)\n --min-heading-level <n> Clamp heading levels to [n, 6] (default 2)\n --heading-anchors Add an id/anchor to each heading from its text\n --code-language <mode> 'drop' (default) or 'class' (emit language-xxx)\n --unsupported <mode> 'html' (default) or 'skip'\n --no-gfm Disable GFM (tables, strikethrough, autolinks)\n -h, --help Show this help\n -v, --version Show version\n`;\n\ninterface CliArgs {\n input?: string;\n output?: string;\n frontmatter: boolean;\n help: boolean;\n version: boolean;\n options: ConvertOptions;\n}\n\nfunction parseArgs(argv: string[]): CliArgs {\n const args: CliArgs = {\n frontmatter: false,\n help: false,\n version: false,\n options: {},\n };\n let positional: string | undefined;\n\n for (let i = 0; i < argv.length; i++) {\n const arg = argv[i];\n switch (arg) {\n case \"-i\":\n case \"--input\":\n args.input = argv[++i];\n break;\n case \"-o\":\n case \"--output\":\n args.output = argv[++i];\n break;\n case \"--frontmatter\":\n args.frontmatter = true;\n break;\n case \"--heading-shift\":\n args.options.headingShift = Number(argv[++i]);\n break;\n case \"--min-heading-level\":\n args.options.minHeadingLevel = Number(argv[++i]);\n break;\n case \"--heading-anchors\":\n args.options.headingAnchors = true;\n break;\n case \"--code-language\":\n args.options.codeLanguage = argv[++i] as ConvertOptions[\"codeLanguage\"];\n break;\n case \"--unsupported\":\n args.options.unsupported = argv[++i] as ConvertOptions[\"unsupported\"];\n break;\n case \"--no-gfm\":\n args.options.gfm = false;\n break;\n case \"-h\":\n case \"--help\":\n args.help = true;\n break;\n case \"-v\":\n case \"--version\":\n args.version = true;\n break;\n default:\n if (arg != null && !arg.startsWith(\"-\") && positional == null) {\n positional = arg;\n }\n break;\n }\n }\n\n // A bare positional file acts as input when -i wasn't given.\n if (args.input == null && positional != null) {\n args.input = positional;\n }\n return args;\n}\n\nfunction readInput(input: string | undefined): string {\n // \"-\" or no input → read stdin; otherwise read the named file.\n const source = input == null || input === \"-\" ? 0 : input;\n return readFileSync(source, \"utf8\");\n}\n\nfunction run(argv: string[]): number {\n const args = parseArgs(argv);\n\n if (args.help) {\n process.stdout.write(HELP);\n return 0;\n }\n if (args.version) {\n process.stdout.write(`${VERSION}\\n`);\n return 0;\n }\n\n // Reading stdin with nothing piped in would hang forever on a TTY — fail fast\n // with a usage hint instead.\n const wantsStdin = args.input == null || args.input === \"-\";\n if (wantsStdin && process.stdin.isTTY) {\n process.stderr.write(\n \"md2blocks: no input provided. Pass -i <file>, give a filename, or pipe Markdown via stdin.\\n\\n\",\n );\n process.stderr.write(HELP);\n return 1;\n }\n\n const markdown = readInput(args.input);\n const result = args.frontmatter\n ? `${JSON.stringify(parseMarkdownDocument(markdown, args.options), null, 2)}\\n`\n : `${markdownToBlocks(markdown, args.options)}\\n`;\n\n if (args.output != null) {\n writeFileSync(args.output, result);\n } else {\n process.stdout.write(result);\n }\n return 0;\n}\n\n// Replaced at build time by tsup `define`; falls back for ts-node/dev runs.\ndeclare const VERSION: string;\n\ntry {\n process.exit(run(process.argv.slice(2)));\n} catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n process.stderr.write(`md2blocks: ${message}\\n`);\n process.exit(1);\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync, writeFileSync } from \"node:fs\";\nimport { markdownToBlocks } from \"./convert.js\";\nimport { parseMarkdownDocument } from \"./document.js\";\nimport {\n applyOptionDefaults,\n type ConvertOptions,\n validateOptions,\n} from \"./types.js\";\n\nconst HELP = `md2blocks — convert Markdown to WordPress/Gutenberg block markup\n\nUsage:\n md2blocks -i <file.md> [-o <out.html>]\n md2blocks <file.md>\n cat doc.md | md2blocks -\n\nOptions:\n -i, --input <file> Input Markdown file (use \"-\" or omit for stdin)\n -o, --output <file> Output file (default: stdout)\n --frontmatter Emit JSON { frontmatter, blocks } instead of markup\n --heading-shift <n> Shift all heading levels by n (default 0)\n --min-heading-level <n> Clamp heading levels to [n, 6], n from 1 to 6 (default 2)\n --heading-anchors Add an id/anchor to each heading from its text\n --code-language <mode> 'drop' (default) or 'class' (emit language-xxx)\n --unsupported <mode> 'html' (default) or 'skip' (drop block and inline HTML)\n --url-schemes <mode> 'safe' (default: http(s)/mailto/tel/relative) or 'any'\n --no-gfm Disable GFM (tables, strikethrough, autolinks)\n -h, --help Show this help\n -v, --version Show version\n`;\n\ninterface CliArgs {\n input?: string;\n output?: string;\n frontmatter: boolean;\n help: boolean;\n version: boolean;\n options: ConvertOptions;\n /** Every argument problem found, reported together before any conversion. */\n errors: string[];\n}\n\n/** Parse an integer flag value, recording an error instead when it isn't one. */\nfunction parseIntegerFlag(\n flag: string,\n value: string | undefined,\n errors: string[],\n): number | undefined {\n let parsed: number | undefined;\n if (value != null) {\n const candidate = value.trim() === \"\" ? Number.NaN : Number(value);\n if (Number.isInteger(candidate)) {\n parsed = candidate;\n } else {\n errors.push(`${flag} expects an integer (got ${JSON.stringify(value)})`);\n }\n }\n return parsed;\n}\n\n/** Parse argv into CLI args, collecting every unknown flag or bad value in `errors`. */\nfunction parseArgs(argv: string[]): CliArgs {\n const args: CliArgs = {\n frontmatter: false,\n help: false,\n version: false,\n options: {},\n errors: [],\n };\n const positionals: string[] = [];\n\n let index = 0;\n while (index < argv.length) {\n const arg = argv[index] ?? \"\";\n index += 1;\n\n // Reads the value following a value-taking flag; `-1` is a valid value.\n const takeValue = (): string | undefined => {\n const value = argv[index];\n if (value == null) {\n args.errors.push(`${arg} requires a value`);\n } else {\n index += 1;\n }\n return value;\n };\n\n switch (arg) {\n case \"-i\":\n case \"--input\":\n args.input = takeValue();\n break;\n case \"-o\":\n case \"--output\":\n args.output = takeValue();\n break;\n case \"--frontmatter\":\n args.frontmatter = true;\n break;\n case \"--heading-shift\":\n args.options.headingShift = parseIntegerFlag(arg, takeValue(), args.errors);\n break;\n case \"--min-heading-level\":\n args.options.minHeadingLevel = parseIntegerFlag(arg, takeValue(), args.errors);\n break;\n case \"--heading-anchors\":\n args.options.headingAnchors = true;\n break;\n case \"--code-language\":\n // Mode values are checked by validateOptions below.\n args.options.codeLanguage = takeValue() as ConvertOptions[\"codeLanguage\"];\n break;\n case \"--unsupported\":\n args.options.unsupported = takeValue() as ConvertOptions[\"unsupported\"];\n break;\n case \"--url-schemes\":\n args.options.urlSchemes = takeValue() as ConvertOptions[\"urlSchemes\"];\n break;\n case \"--no-gfm\":\n args.options.gfm = false;\n break;\n case \"-h\":\n case \"--help\":\n args.help = true;\n break;\n case \"-v\":\n case \"--version\":\n args.version = true;\n break;\n default:\n if (arg.startsWith(\"-\") && arg !== \"-\") {\n args.errors.push(`unknown option ${arg}`);\n } else {\n positionals.push(arg);\n }\n break;\n }\n }\n\n // A bare positional file acts as input when -i wasn't given.\n const [positional, ...extra] = positionals;\n if (positional != null && args.input == null) {\n args.input = positional;\n } else if (positional != null) {\n extra.unshift(positional);\n }\n for (const unexpected of extra) {\n args.errors.push(`unexpected argument ${JSON.stringify(unexpected)}`);\n }\n\n args.errors.push(...validateOptions(applyOptionDefaults(args.options)));\n return args;\n}\n\nfunction readInput(input: string | undefined): string {\n // \"-\" or no input → read stdin; otherwise read the named file.\n const source = input == null || input === \"-\" ? 0 : input;\n return readFileSync(source, \"utf8\");\n}\n\nfunction run(argv: string[]): number {\n const args = parseArgs(argv);\n\n if (args.help) {\n process.stdout.write(HELP);\n return 0;\n }\n if (args.version) {\n process.stdout.write(`${VERSION}\\n`);\n return 0;\n }\n if (args.errors.length > 0) {\n for (const error of args.errors) {\n process.stderr.write(`md2blocks: ${error}\\n`);\n }\n process.stderr.write(\"Run md2blocks --help for usage.\\n\");\n return 1;\n }\n\n // Reading stdin with nothing piped in would hang forever on a TTY — fail fast\n // with a usage hint instead.\n const wantsStdin = args.input == null || args.input === \"-\";\n if (wantsStdin && process.stdin.isTTY) {\n process.stderr.write(\n \"md2blocks: no input provided. Pass -i <file>, give a filename, or pipe Markdown via stdin.\\n\\n\",\n );\n process.stderr.write(HELP);\n return 1;\n }\n\n const markdown = readInput(args.input);\n const result = args.frontmatter\n ? `${JSON.stringify(parseMarkdownDocument(markdown, args.options), null, 2)}\\n`\n : `${markdownToBlocks(markdown, args.options)}\\n`;\n\n if (args.output != null) {\n writeFileSync(args.output, result);\n } else {\n process.stdout.write(result);\n }\n return 0;\n}\n\n// Replaced at build time by tsup `define`; falls back for ts-node/dev runs.\ndeclare const VERSION: string;\n\n// Exit code a shell reports for a process killed by SIGPIPE (128 + 13).\nconst EXIT_BROKEN_PIPE = 141;\n\n/** Writes a CLI error message to stderr. */\nfunction reportError(error: unknown): void {\n const message = error instanceof Error ? error.message : String(error);\n process.stderr.write(`md2blocks: ${message}\\n`);\n}\n\n// Node ignores SIGPIPE, so a reader closing early (`| head`) surfaces as EPIPE.\nprocess.stdout.on(\"error\", (error: NodeJS.ErrnoException) => {\n if (error.code === \"EPIPE\") {\n process.exit(EXIT_BROKEN_PIPE);\n } else {\n reportError(error);\n process.exit(1);\n }\n});\n\n// Set exitCode rather than calling process.exit(): exiting immediately drops\n// any stdout still queued for a full pipe.\ntry {\n process.exitCode = run(process.argv.slice(2));\n} catch (error) {\n reportError(error);\n process.exitCode = 1;\n}\n"],"mappings":"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","names":[]}
package/dist/index.d.ts CHANGED
@@ -14,7 +14,7 @@ interface ConvertOptions {
14
14
  * Set to 1 for docs whose first section is `#`, so `#`→h2 and body never emits h1.
15
15
  */
16
16
  headingShift?: number;
17
- /** Clamp resulting heading levels into [min, 6]. Default min = 2 (avoid body h1). */
17
+ /** Clamp resulting heading levels into [min, 6]; min must be 1–6. Default 2 (avoid body h1). */
18
18
  minHeadingLevel?: number;
19
19
  /**
20
20
  * Derive an `id` (WordPress `anchor` attribute) for every heading from its
@@ -34,8 +34,17 @@ interface ConvertOptions {
34
34
  * 'class': add `language-xxx` to the <code> for a Prism/highlight.js plugin.
35
35
  */
36
36
  codeLanguage?: "drop" | "class";
37
- /** How to handle unsupported / raw-HTML nodes. 'html' (default) → core/html. 'skip' → omit. */
37
+ /**
38
+ * How to handle unsupported / raw-HTML nodes. 'html' (default): block HTML →
39
+ * core/html, inline HTML verbatim. 'skip': omit both.
40
+ */
38
41
  unsupported?: "html" | "skip";
42
+ /**
43
+ * 'safe' (default): links keep their href only for http(s), mailto, tel or
44
+ * relative URLs (otherwise just the link text renders); images need http(s)
45
+ * or relative URLs (otherwise they are dropped). 'any': no scheme check.
46
+ */
47
+ urlSchemes?: "safe" | "any";
39
48
  /** Enable GFM (tables, strikethrough, autolinks). Default true. */
40
49
  gfm?: boolean;
41
50
  }
@@ -58,4 +67,5 @@ declare function markdownToBlocks(markdown: string, options?: ConvertOptions): s
58
67
  */
59
68
  declare function parseMarkdownDocument(markdown: string, options?: ConvertOptions): ParsedDocument;
60
69
 
61
- export { type ConvertOptions, type ParsedDocument, type ResolvedImage, markdownToBlockList, markdownToBlocks, parseMarkdownDocument };
70
+ export { markdownToBlockList, markdownToBlocks, parseMarkdownDocument };
71
+ export type { ConvertOptions, ParsedDocument, ResolvedImage };
package/dist/index.js CHANGED
@@ -4,7 +4,7 @@ import {
4
4
  markdownToBlockList,
5
5
  markdownToBlocks,
6
6
  parseMarkdownDocument
7
- } from "./chunk-CHMDS2SX.js";
7
+ } from "./chunk-26IEHNWU.js";
8
8
  export {
9
9
  markdownToBlockList,
10
10
  markdownToBlocks,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@headwall/markdown-to-blocks",
3
- "version": "1.2.0",
3
+ "version": "1.4.0",
4
4
  "description": "Convert Markdown into serialised WordPress/Gutenberg block markup (core blocks, with <!-- wp:... --> delimiters).",
5
5
  "keywords": [
6
6
  "markdown",
@@ -22,7 +22,7 @@
22
22
  "url": "https://github.com/headwalluk/markdown-to-blocks/issues"
23
23
  },
24
24
  "engines": {
25
- "node": ">=20"
25
+ "node": ">=22"
26
26
  },
27
27
  "exports": {
28
28
  ".": {
@@ -47,6 +47,7 @@
47
47
  "scripts": {
48
48
  "build": "tsup",
49
49
  "dev": "tsup --watch",
50
+ "pretest": "npm run build",
50
51
  "test": "vitest run",
51
52
  "test:watch": "vitest",
52
53
  "typecheck": "tsc --noEmit",
@@ -54,18 +55,18 @@
54
55
  },
55
56
  "devDependencies": {
56
57
  "@types/mdast": "^4.0.4",
57
- "@types/node": "^22.10.0",
58
- "@wordpress/block-library": "^10.0.0",
59
- "@wordpress/blocks": "^15.22.0",
60
- "jsdom": "^29.1.1",
58
+ "@types/node": "^22.20.5",
59
+ "@wordpress/block-library": "^12.2.0",
60
+ "@wordpress/blocks": "^17.2.0",
61
+ "jsdom": "^31.0.1",
61
62
  "remark-frontmatter": "^5.0.0",
62
63
  "remark-gfm": "^4.0.0",
63
64
  "remark-parse": "^11.0.0",
64
- "tsup": "^8.3.5",
65
+ "tsup": "^9.0.0",
65
66
  "typescript": "^5.7.2",
66
67
  "unified": "^11.0.5",
67
- "unist-util-visit": "^5.0.0",
68
- "vitest": "^4.1.9",
68
+ "unist-util-visit": "^5.2.0",
69
+ "vitest": "^5.1.1",
69
70
  "yaml": "^2.6.1"
70
71
  }
71
72
  }