@headwall/markdown-to-blocks 1.3.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/CHANGELOG.md +56 -1
- package/README.md +29 -3
- package/dist/{chunk-FWYKR6IX.js → chunk-26IEHNWU.js} +265 -104
- package/dist/chunk-26IEHNWU.js.map +1 -0
- package/dist/cli.js +65 -18
- package/dist/cli.js.map +1 -1
- package/dist/index.d.ts +13 -3
- package/dist/index.js +1 -1
- package/package.json +7 -7
- package/dist/chunk-FWYKR6IX.js.map +0 -1
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
|
-
|
|
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
|
-
|
|
39
|
-
|
|
40
|
-
|
|
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 =
|
|
71
|
+
args.input = takeValue();
|
|
45
72
|
break;
|
|
46
73
|
case "-o":
|
|
47
74
|
case "--output":
|
|
48
|
-
args.output =
|
|
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 =
|
|
81
|
+
args.options.headingShift = parseIntegerFlag(arg, takeValue(), args.errors);
|
|
55
82
|
break;
|
|
56
83
|
case "--min-heading-level":
|
|
57
|
-
args.options.minHeadingLevel =
|
|
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 =
|
|
90
|
+
args.options.codeLanguage = takeValue();
|
|
64
91
|
break;
|
|
65
92
|
case "--unsupported":
|
|
66
|
-
args.options.unsupported =
|
|
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
|
|
81
|
-
|
|
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
|
-
|
|
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);
|
|
123
|
+
}
|
|
124
|
+
for (const unexpected of extra) {
|
|
125
|
+
args.errors.push(`unexpected argument ${JSON.stringify(unexpected)}`);
|
|
88
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.
|
|
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(
|
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\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":[]}
|
|
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
|
|
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
|
-
/**
|
|
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 {
|
|
70
|
+
export { markdownToBlockList, markdownToBlocks, parseMarkdownDocument };
|
|
71
|
+
export type { ConvertOptions, ParsedDocument, ResolvedImage };
|
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@headwall/markdown-to-blocks",
|
|
3
|
-
"version": "1.
|
|
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",
|
|
@@ -56,17 +56,17 @@
|
|
|
56
56
|
"devDependencies": {
|
|
57
57
|
"@types/mdast": "^4.0.4",
|
|
58
58
|
"@types/node": "^22.20.5",
|
|
59
|
-
"@wordpress/block-library": "^
|
|
60
|
-
"@wordpress/blocks": "^
|
|
61
|
-
"jsdom": "^
|
|
59
|
+
"@wordpress/block-library": "^12.2.0",
|
|
60
|
+
"@wordpress/blocks": "^17.2.0",
|
|
61
|
+
"jsdom": "^31.0.1",
|
|
62
62
|
"remark-frontmatter": "^5.0.0",
|
|
63
63
|
"remark-gfm": "^4.0.0",
|
|
64
64
|
"remark-parse": "^11.0.0",
|
|
65
|
-
"tsup": "^
|
|
65
|
+
"tsup": "^9.0.0",
|
|
66
66
|
"typescript": "^5.7.2",
|
|
67
67
|
"unified": "^11.0.5",
|
|
68
|
-
"unist-util-visit": "^5.
|
|
69
|
-
"vitest": "^5.
|
|
68
|
+
"unist-util-visit": "^5.2.0",
|
|
69
|
+
"vitest": "^5.1.1",
|
|
70
70
|
"yaml": "^2.6.1"
|
|
71
71
|
}
|
|
72
72
|
}
|