@kubb/parser-md 5.0.0-beta.62 → 5.0.0-beta.64

package/dist/index.cjs

@@ -5,24 +5,17 @@ let _kubb_ast_utils = require("@kubb/ast/utils");
 let yaml = require("yaml");
 //#region src/utils.ts
 /**
-* Wraps a plain object as a YAML frontmatter envelope:
-*
-* ```
-* ---
-* <yaml>
-* ---
-* ```
-*
+* Wraps a plain object as a YAML frontmatter envelope (`---\n<yaml>\n---`).
 * Returns an empty string for `null`, `undefined`, or empty objects so callers
-* can drop the result through the same filter chain as banner/footer fields.
+* can drop the result through the same filter chain as other optional fields.
 */
-function printFrontmatter(data) {
+function stringifyFrontmatter(data) {
 	if (!data || Object.keys(data).length === 0) return "";
 	return `---\n${(0, yaml.stringify)(data).trimEnd()}\n---`;
 }
 /**
 * Joins a list of markdown fragments with blank lines. Plain objects are
-* rendered as YAML frontmatter via {@link printFrontmatter}, and strings pass
+* rendered as YAML frontmatter via {@link stringifyFrontmatter}, and strings pass
 * through unchanged.
 *
 * @example
@@ -35,7 +28,7 @@ function print(...parts) {
 	const rendered = [];
 	for (const part of parts) {
 		if (part === null || part === void 0 || part === "") continue;
-		const text = typeof part === "string" ? part : printFrontmatter(part);
+		const text = typeof part === "string" ? part : stringifyFrontmatter(part);
 		if (text) rendered.push(text.trimEnd());
 	}
 	return rendered.join("\n\n");

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/utils.ts","../src/parserMd.ts"],"sourcesContent":["import { stringify } from 'yaml'\n\n/**\n * Markdown `print` input, either a markdown text fragment (passed through\n * verbatim) or a plain object that is serialized as a YAML frontmatter envelope.\n */\nexport type PrintInput = string | Record<string, unknown>\n\n/**\n * Wraps a plain object as a YAML frontmatter envelope:\n *\n * ```\n * ---\n * <yaml>\n * ---\n * ```\n *\n * Returns an empty string for `null`, `undefined`, or empty objects so callers\n * can drop the result through the same filter chain as banner/footer fields.\n */\nfunction printFrontmatter(data: Record<string, unknown> | null | undefined): string {\n  if (!data || Object.keys(data).length === 0) return ''\n  return `---\\n${stringify(data).trimEnd()}\\n---`\n}\n\n/**\n * Joins a list of markdown fragments with blank lines. Plain objects are\n * rendered as YAML frontmatter via {@link printFrontmatter}, and strings pass\n * through unchanged.\n *\n * @example\n * ```ts\n * print({ title: 'Hi' }, '# Hello')\n * // '---\\ntitle: Hi\\n---\\n\\n# Hello'\n * ```\n */\nexport function print(...parts: Array<PrintInput | null | undefined>): string {\n  const rendered: Array<string> = []\n  for (const part of parts) {\n    if (part === null || part === undefined || part === '') continue\n    const text = typeof part === 'string' ? part : printFrontmatter(part)\n    if (text) rendered.push(text.trimEnd())\n  }\n  return rendered.join('\\n\\n')\n}\n","import type { ast } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport { extractStringsFromNodes } from '@kubb/ast/utils'\n\nimport { print, type PrintInput } from './utils.ts'\n\n/**\n * Metadata accepted by `parserMd`. Set `frontmatter` on a `<File meta={…}>` to\n * have the parser prepend the corresponding YAML envelope.\n */\nexport type MdMeta = {\n  frontmatter?: Record<string, unknown> | null\n}\n\n/**\n * Kubb parser for `.md` and `.markdown` files. Joins source blocks as plain\n * markdown (separated by blank lines) and, when `file.meta.frontmatter` is set,\n * prepends a YAML frontmatter envelope produced by `parserMd.print`.\n *\n * Add to the `parsers` array on `defineConfig` to opt in. `parserTs` keeps\n * handling `.ts`/`.js` files, `parserMd` claims `.md`/`.markdown`.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { adapterOas } from '@kubb/adapter-oas'\n * import { parserMd } from '@kubb/parser-md'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   adapter: adapterOas(),\n *   parsers: [parserMd],\n *   plugins: [],\n * })\n * ```\n */\nexport const parserMd = defineParser({\n  name: 'markdown',\n  extNames: ['.md', '.markdown'],\n  print(...parts: Array<PrintInput>) {\n    return print(...parts)\n  },\n  parse(file) {\n    const sourceParts: Array<string> = []\n    for (const source of file.sources) {\n      const text = extractStringsFromNodes(source.nodes as Array<ast.CodeNode>)\n      if (text) sourceParts.push(text.trimEnd())\n    }\n    const body = sourceParts.join('\\n\\n')\n\n    const meta = file.meta as MdMeta | undefined\n    const frontmatter = print(meta?.frontmatter ?? undefined)\n\n    const parts = [file.banner, frontmatter, body, file.footer].filter((segment): segment is string => Boolean(segment)).map((segment) => segment.trimEnd())\n\n    return parts.join('\\n\\n')\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoBA,SAAS,iBAAiB,MAA0D;CAClF,IAAI,CAAC,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,WAAW,GAAG,OAAO;CACpD,OAAO,SAAA,GAAA,KAAA,UAAA,CAAkB,IAAI,CAAC,CAAC,QAAQ,EAAE;AAC3C;;;;;;;;;;;;AAaA,SAAgB,MAAM,GAAG,OAAqD;CAC5E,MAAM,WAA0B,CAAC;CACjC,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,SAAS,QAAQ,SAAS,KAAA,KAAa,SAAS,IAAI;EACxD,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,iBAAiB,IAAI;EACpE,IAAI,MAAM,SAAS,KAAK,KAAK,QAAQ,CAAC;CACxC;CACA,OAAO,SAAS,KAAK,MAAM;AAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;ACPA,MAAa,YAAA,GAAA,WAAA,aAAA,CAAwB;CACnC,MAAM;CACN,UAAU,CAAC,OAAO,WAAW;CAC7B,MAAM,GAAG,OAA0B;EACjC,OAAO,MAAM,GAAG,KAAK;CACvB;CACA,MAAM,MAAM;EACV,MAAM,cAA6B,CAAC;EACpC,KAAK,MAAM,UAAU,KAAK,SAAS;GACjC,MAAM,QAAA,GAAA,gBAAA,wBAAA,CAA+B,OAAO,KAA4B;GACxE,IAAI,MAAM,YAAY,KAAK,KAAK,QAAQ,CAAC;EAC3C;EACA,MAAM,OAAO,YAAY,KAAK,MAAM;EAEpC,MAAM,OAAO,KAAK;EAClB,MAAM,cAAc,MAAM,MAAM,eAAe,KAAA,CAAS;EAIxD,OAFc;GAAC,KAAK;GAAQ;GAAa;GAAM,KAAK;EAAM,CAAC,CAAC,QAAQ,YAA+B,QAAQ,OAAO,CAAC,CAAC,CAAC,KAAK,YAAY,QAAQ,QAAQ,CAE3I,CAAC,CAAC,KAAK,MAAM;CAC1B;AACF,CAAC"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/utils.ts","../src/parserMd.ts"],"sourcesContent":["import { stringify } from 'yaml'\n\n/**\n * Markdown `print` input, either a markdown text fragment (passed through\n * verbatim) or a plain object that is serialized as a YAML frontmatter envelope.\n */\nexport type PrintInput = string | Record<string, unknown>\n\n/**\n * Wraps a plain object as a YAML frontmatter envelope (`---\\n<yaml>\\n---`).\n * Returns an empty string for `null`, `undefined`, or empty objects so callers\n * can drop the result through the same filter chain as other optional fields.\n */\nexport function stringifyFrontmatter(data: Record<string, unknown> | null | undefined): string {\n  if (!data || Object.keys(data).length === 0) return ''\n  return `---\\n${stringify(data).trimEnd()}\\n---`\n}\n\n/**\n * Joins a list of markdown fragments with blank lines. Plain objects are\n * rendered as YAML frontmatter via {@link stringifyFrontmatter}, and strings pass\n * through unchanged.\n *\n * @example\n * ```ts\n * print({ title: 'Hi' }, '# Hello')\n * // '---\\ntitle: Hi\\n---\\n\\n# Hello'\n * ```\n */\nexport function print(...parts: Array<PrintInput | null | undefined>): string {\n  const rendered: Array<string> = []\n  for (const part of parts) {\n    if (part === null || part === undefined || part === '') continue\n    const text = typeof part === 'string' ? part : stringifyFrontmatter(part)\n    if (text) rendered.push(text.trimEnd())\n  }\n  return rendered.join('\\n\\n')\n}\n","import type { ast } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport { extractStringsFromNodes } from '@kubb/ast/utils'\n\nimport { print, type PrintInput } from './utils.ts'\n\n/**\n * Metadata accepted by `parserMd`. Set `frontmatter` on a `<File meta={...}>` and\n * the parser prepends those keys as a YAML frontmatter envelope.\n */\nexport type MdMeta = {\n  frontmatter?: Record<string, unknown> | null\n}\n\n/**\n * Kubb parser for `.md` and `.markdown` files. Joins source blocks as plain\n * markdown (separated by blank lines) and, when `file.meta.frontmatter` is set,\n * prepends a YAML frontmatter envelope produced by `parserMd.print`.\n *\n * Add to the `parsers` array on `defineConfig` to opt in. `parserTs` keeps\n * handling `.ts`/`.js` files, `parserMd` claims `.md`/`.markdown`.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { adapterOas } from '@kubb/adapter-oas'\n * import { parserMd } from '@kubb/parser-md'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   adapter: adapterOas(),\n *   parsers: [parserMd],\n *   plugins: [],\n * })\n * ```\n */\nexport const parserMd = defineParser({\n  name: 'markdown',\n  extNames: ['.md', '.markdown'],\n  print(...parts: Array<PrintInput>) {\n    return print(...parts)\n  },\n  parse(file) {\n    const sourceParts: Array<string> = []\n    for (const source of file.sources) {\n      const text = extractStringsFromNodes(source.nodes as Array<ast.CodeNode>)\n      if (text) sourceParts.push(text.trimEnd())\n    }\n    const body = sourceParts.join('\\n\\n')\n\n    const meta = file.meta as MdMeta | undefined\n    const frontmatter = print(meta?.frontmatter ?? undefined)\n\n    const parts = [file.banner, frontmatter, body, file.footer].filter((segment): segment is string => Boolean(segment)).map((segment) => segment.trimEnd())\n\n    return parts.join('\\n\\n')\n  },\n})\n"],"mappings":";;;;;;;;;;;AAaA,SAAgB,qBAAqB,MAA0D;CAC7F,IAAI,CAAC,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,WAAW,GAAG,OAAO;CACpD,OAAO,SAAA,GAAA,KAAA,UAAA,CAAkB,IAAI,CAAC,CAAC,QAAQ,EAAE;AAC3C;;;;;;;;;;;;AAaA,SAAgB,MAAM,GAAG,OAAqD;CAC5E,MAAM,WAA0B,CAAC;CACjC,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,SAAS,QAAQ,SAAS,KAAA,KAAa,SAAS,IAAI;EACxD,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,qBAAqB,IAAI;EACxE,IAAI,MAAM,SAAS,KAAK,KAAK,QAAQ,CAAC;CACxC;CACA,OAAO,SAAS,KAAK,MAAM;AAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;ACAA,MAAa,YAAA,GAAA,WAAA,aAAA,CAAwB;CACnC,MAAM;CACN,UAAU,CAAC,OAAO,WAAW;CAC7B,MAAM,GAAG,OAA0B;EACjC,OAAO,MAAM,GAAG,KAAK;CACvB;CACA,MAAM,MAAM;EACV,MAAM,cAA6B,CAAC;EACpC,KAAK,MAAM,UAAU,KAAK,SAAS;GACjC,MAAM,QAAA,GAAA,gBAAA,wBAAA,CAA+B,OAAO,KAA4B;GACxE,IAAI,MAAM,YAAY,KAAK,KAAK,QAAQ,CAAC;EAC3C;EACA,MAAM,OAAO,YAAY,KAAK,MAAM;EAEpC,MAAM,OAAO,KAAK;EAClB,MAAM,cAAc,MAAM,MAAM,eAAe,KAAA,CAAS;EAIxD,OAFc;GAAC,KAAK;GAAQ;GAAa;GAAM,KAAK;EAAM,CAAC,CAAC,QAAQ,YAA+B,QAAQ,OAAO,CAAC,CAAC,CAAC,KAAK,YAAY,QAAQ,QAAQ,CAE3I,CAAC,CAAC,KAAK,MAAM;CAC1B;AACF,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { t as __name } from "./chunk-C0LytTxp.js";
+import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
 import { ast } from "@kubb/core";
 
 //#region src/utils.d.ts
@@ -10,8 +10,8 @@ type PrintInput = string | Record<string, unknown>;
 //#endregion
 //#region src/parserMd.d.ts
 /**
- * Metadata accepted by `parserMd`. Set `frontmatter` on a `<File meta={…}>` to
- * have the parser prepend the corresponding YAML envelope.
+ * Metadata accepted by `parserMd`. Set `frontmatter` on a `<File meta={...}>` and
+ * the parser prepends those keys as a YAML frontmatter envelope.
  */
 type MdMeta = {
   frontmatter?: Record<string, unknown> | null;

package/dist/index.js

@@ -1,27 +1,20 @@
-import "./chunk-C0LytTxp.js";
+import "./rolldown-runtime-C0LytTxp.js";
 import { defineParser } from "@kubb/core";
 import { extractStringsFromNodes } from "@kubb/ast/utils";
 import { stringify } from "yaml";
 //#region src/utils.ts
 /**
-* Wraps a plain object as a YAML frontmatter envelope:
-*
-* ```
-* ---
-* <yaml>
-* ---
-* ```
-*
+* Wraps a plain object as a YAML frontmatter envelope (`---\n<yaml>\n---`).
 * Returns an empty string for `null`, `undefined`, or empty objects so callers
-* can drop the result through the same filter chain as banner/footer fields.
+* can drop the result through the same filter chain as other optional fields.
 */
-function printFrontmatter(data) {
+function stringifyFrontmatter(data) {
 	if (!data || Object.keys(data).length === 0) return "";
 	return `---\n${stringify(data).trimEnd()}\n---`;
 }
 /**
 * Joins a list of markdown fragments with blank lines. Plain objects are
-* rendered as YAML frontmatter via {@link printFrontmatter}, and strings pass
+* rendered as YAML frontmatter via {@link stringifyFrontmatter}, and strings pass
 * through unchanged.
 *
 * @example
@@ -34,7 +27,7 @@ function print(...parts) {
 	const rendered = [];
 	for (const part of parts) {
 		if (part === null || part === void 0 || part === "") continue;
-		const text = typeof part === "string" ? part : printFrontmatter(part);
+		const text = typeof part === "string" ? part : stringifyFrontmatter(part);
 		if (text) rendered.push(text.trimEnd());
 	}
 	return rendered.join("\n\n");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/utils.ts","../src/parserMd.ts"],"sourcesContent":["import { stringify } from 'yaml'\n\n/**\n * Markdown `print` input, either a markdown text fragment (passed through\n * verbatim) or a plain object that is serialized as a YAML frontmatter envelope.\n */\nexport type PrintInput = string | Record<string, unknown>\n\n/**\n * Wraps a plain object as a YAML frontmatter envelope:\n *\n * ```\n * ---\n * <yaml>\n * ---\n * ```\n *\n * Returns an empty string for `null`, `undefined`, or empty objects so callers\n * can drop the result through the same filter chain as banner/footer fields.\n */\nfunction printFrontmatter(data: Record<string, unknown> | null | undefined): string {\n  if (!data || Object.keys(data).length === 0) return ''\n  return `---\\n${stringify(data).trimEnd()}\\n---`\n}\n\n/**\n * Joins a list of markdown fragments with blank lines. Plain objects are\n * rendered as YAML frontmatter via {@link printFrontmatter}, and strings pass\n * through unchanged.\n *\n * @example\n * ```ts\n * print({ title: 'Hi' }, '# Hello')\n * // '---\\ntitle: Hi\\n---\\n\\n# Hello'\n * ```\n */\nexport function print(...parts: Array<PrintInput | null | undefined>): string {\n  const rendered: Array<string> = []\n  for (const part of parts) {\n    if (part === null || part === undefined || part === '') continue\n    const text = typeof part === 'string' ? part : printFrontmatter(part)\n    if (text) rendered.push(text.trimEnd())\n  }\n  return rendered.join('\\n\\n')\n}\n","import type { ast } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport { extractStringsFromNodes } from '@kubb/ast/utils'\n\nimport { print, type PrintInput } from './utils.ts'\n\n/**\n * Metadata accepted by `parserMd`. Set `frontmatter` on a `<File meta={…}>` to\n * have the parser prepend the corresponding YAML envelope.\n */\nexport type MdMeta = {\n  frontmatter?: Record<string, unknown> | null\n}\n\n/**\n * Kubb parser for `.md` and `.markdown` files. Joins source blocks as plain\n * markdown (separated by blank lines) and, when `file.meta.frontmatter` is set,\n * prepends a YAML frontmatter envelope produced by `parserMd.print`.\n *\n * Add to the `parsers` array on `defineConfig` to opt in. `parserTs` keeps\n * handling `.ts`/`.js` files, `parserMd` claims `.md`/`.markdown`.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { adapterOas } from '@kubb/adapter-oas'\n * import { parserMd } from '@kubb/parser-md'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   adapter: adapterOas(),\n *   parsers: [parserMd],\n *   plugins: [],\n * })\n * ```\n */\nexport const parserMd = defineParser({\n  name: 'markdown',\n  extNames: ['.md', '.markdown'],\n  print(...parts: Array<PrintInput>) {\n    return print(...parts)\n  },\n  parse(file) {\n    const sourceParts: Array<string> = []\n    for (const source of file.sources) {\n      const text = extractStringsFromNodes(source.nodes as Array<ast.CodeNode>)\n      if (text) sourceParts.push(text.trimEnd())\n    }\n    const body = sourceParts.join('\\n\\n')\n\n    const meta = file.meta as MdMeta | undefined\n    const frontmatter = print(meta?.frontmatter ?? undefined)\n\n    const parts = [file.banner, frontmatter, body, file.footer].filter((segment): segment is string => Boolean(segment)).map((segment) => segment.trimEnd())\n\n    return parts.join('\\n\\n')\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,SAAS,iBAAiB,MAA0D;CAClF,IAAI,CAAC,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,WAAW,GAAG,OAAO;CACpD,OAAO,QAAQ,UAAU,IAAI,CAAC,CAAC,QAAQ,EAAE;AAC3C;;;;;;;;;;;;AAaA,SAAgB,MAAM,GAAG,OAAqD;CAC5E,MAAM,WAA0B,CAAC;CACjC,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,SAAS,QAAQ,SAAS,KAAA,KAAa,SAAS,IAAI;EACxD,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,iBAAiB,IAAI;EACpE,IAAI,MAAM,SAAS,KAAK,KAAK,QAAQ,CAAC;CACxC;CACA,OAAO,SAAS,KAAK,MAAM;AAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;ACPA,MAAa,WAAW,aAAa;CACnC,MAAM;CACN,UAAU,CAAC,OAAO,WAAW;CAC7B,MAAM,GAAG,OAA0B;EACjC,OAAO,MAAM,GAAG,KAAK;CACvB;CACA,MAAM,MAAM;EACV,MAAM,cAA6B,CAAC;EACpC,KAAK,MAAM,UAAU,KAAK,SAAS;GACjC,MAAM,OAAO,wBAAwB,OAAO,KAA4B;GACxE,IAAI,MAAM,YAAY,KAAK,KAAK,QAAQ,CAAC;EAC3C;EACA,MAAM,OAAO,YAAY,KAAK,MAAM;EAEpC,MAAM,OAAO,KAAK;EAClB,MAAM,cAAc,MAAM,MAAM,eAAe,KAAA,CAAS;EAIxD,OAFc;GAAC,KAAK;GAAQ;GAAa;GAAM,KAAK;EAAM,CAAC,CAAC,QAAQ,YAA+B,QAAQ,OAAO,CAAC,CAAC,CAAC,KAAK,YAAY,QAAQ,QAAQ,CAE3I,CAAC,CAAC,KAAK,MAAM;CAC1B;AACF,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/utils.ts","../src/parserMd.ts"],"sourcesContent":["import { stringify } from 'yaml'\n\n/**\n * Markdown `print` input, either a markdown text fragment (passed through\n * verbatim) or a plain object that is serialized as a YAML frontmatter envelope.\n */\nexport type PrintInput = string | Record<string, unknown>\n\n/**\n * Wraps a plain object as a YAML frontmatter envelope (`---\\n<yaml>\\n---`).\n * Returns an empty string for `null`, `undefined`, or empty objects so callers\n * can drop the result through the same filter chain as other optional fields.\n */\nexport function stringifyFrontmatter(data: Record<string, unknown> | null | undefined): string {\n  if (!data || Object.keys(data).length === 0) return ''\n  return `---\\n${stringify(data).trimEnd()}\\n---`\n}\n\n/**\n * Joins a list of markdown fragments with blank lines. Plain objects are\n * rendered as YAML frontmatter via {@link stringifyFrontmatter}, and strings pass\n * through unchanged.\n *\n * @example\n * ```ts\n * print({ title: 'Hi' }, '# Hello')\n * // '---\\ntitle: Hi\\n---\\n\\n# Hello'\n * ```\n */\nexport function print(...parts: Array<PrintInput | null | undefined>): string {\n  const rendered: Array<string> = []\n  for (const part of parts) {\n    if (part === null || part === undefined || part === '') continue\n    const text = typeof part === 'string' ? part : stringifyFrontmatter(part)\n    if (text) rendered.push(text.trimEnd())\n  }\n  return rendered.join('\\n\\n')\n}\n","import type { ast } from '@kubb/core'\nimport { defineParser } from '@kubb/core'\nimport { extractStringsFromNodes } from '@kubb/ast/utils'\n\nimport { print, type PrintInput } from './utils.ts'\n\n/**\n * Metadata accepted by `parserMd`. Set `frontmatter` on a `<File meta={...}>` and\n * the parser prepends those keys as a YAML frontmatter envelope.\n */\nexport type MdMeta = {\n  frontmatter?: Record<string, unknown> | null\n}\n\n/**\n * Kubb parser for `.md` and `.markdown` files. Joins source blocks as plain\n * markdown (separated by blank lines) and, when `file.meta.frontmatter` is set,\n * prepends a YAML frontmatter envelope produced by `parserMd.print`.\n *\n * Add to the `parsers` array on `defineConfig` to opt in. `parserTs` keeps\n * handling `.ts`/`.js` files, `parserMd` claims `.md`/`.markdown`.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { adapterOas } from '@kubb/adapter-oas'\n * import { parserMd } from '@kubb/parser-md'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   adapter: adapterOas(),\n *   parsers: [parserMd],\n *   plugins: [],\n * })\n * ```\n */\nexport const parserMd = defineParser({\n  name: 'markdown',\n  extNames: ['.md', '.markdown'],\n  print(...parts: Array<PrintInput>) {\n    return print(...parts)\n  },\n  parse(file) {\n    const sourceParts: Array<string> = []\n    for (const source of file.sources) {\n      const text = extractStringsFromNodes(source.nodes as Array<ast.CodeNode>)\n      if (text) sourceParts.push(text.trimEnd())\n    }\n    const body = sourceParts.join('\\n\\n')\n\n    const meta = file.meta as MdMeta | undefined\n    const frontmatter = print(meta?.frontmatter ?? undefined)\n\n    const parts = [file.banner, frontmatter, body, file.footer].filter((segment): segment is string => Boolean(segment)).map((segment) => segment.trimEnd())\n\n    return parts.join('\\n\\n')\n  },\n})\n"],"mappings":";;;;;;;;;;AAaA,SAAgB,qBAAqB,MAA0D;CAC7F,IAAI,CAAC,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,WAAW,GAAG,OAAO;CACpD,OAAO,QAAQ,UAAU,IAAI,CAAC,CAAC,QAAQ,EAAE;AAC3C;;;;;;;;;;;;AAaA,SAAgB,MAAM,GAAG,OAAqD;CAC5E,MAAM,WAA0B,CAAC;CACjC,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,SAAS,QAAQ,SAAS,KAAA,KAAa,SAAS,IAAI;EACxD,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,qBAAqB,IAAI;EACxE,IAAI,MAAM,SAAS,KAAK,KAAK,QAAQ,CAAC;CACxC;CACA,OAAO,SAAS,KAAK,MAAM;AAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;ACAA,MAAa,WAAW,aAAa;CACnC,MAAM;CACN,UAAU,CAAC,OAAO,WAAW;CAC7B,MAAM,GAAG,OAA0B;EACjC,OAAO,MAAM,GAAG,KAAK;CACvB;CACA,MAAM,MAAM;EACV,MAAM,cAA6B,CAAC;EACpC,KAAK,MAAM,UAAU,KAAK,SAAS;GACjC,MAAM,OAAO,wBAAwB,OAAO,KAA4B;GACxE,IAAI,MAAM,YAAY,KAAK,KAAK,QAAQ,CAAC;EAC3C;EACA,MAAM,OAAO,YAAY,KAAK,MAAM;EAEpC,MAAM,OAAO,KAAK;EAClB,MAAM,cAAc,MAAM,MAAM,eAAe,KAAA,CAAS;EAIxD,OAFc;GAAC,KAAK;GAAQ;GAAa;GAAM,KAAK;EAAM,CAAC,CAAC,QAAQ,YAA+B,QAAQ,OAAO,CAAC,CAAC,CAAC,KAAK,YAAY,QAAQ,QAAQ,CAE3I,CAAC,CAAC,KAAK,MAAM;CAC1B;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/parser-md",
-  "version": "5.0.0-beta.62",
+  "version": "5.0.0-beta.64",
   "description": "Markdown source file parser for Kubb. Converts the universal AST to `.md` source and renders YAML frontmatter via the `print` helper.",
   "keywords": [
     "codegen",
@@ -18,7 +18,6 @@
     "directory": "packages/parser-md"
   },
   "files": [
-    "src",
     "dist",
     "!/**/**.test.**",
     "!/**/__tests__/**",
@@ -42,8 +41,8 @@
   },
   "dependencies": {
     "yaml": "^2.9.0",
-    "@kubb/ast": "5.0.0-beta.62",
-    "@kubb/core": "5.0.0-beta.62"
+    "@kubb/ast": "5.0.0-beta.64",
+    "@kubb/core": "5.0.0-beta.64"
   },
   "devDependencies": {
     "@internals/utils": "0.0.0"

package/src/index.ts

@@ -1 +0,0 @@
-export { parserMd, type MdMeta } from './parserMd.ts'

package/src/parserMd.ts

@@ -1,59 +0,0 @@
-import type { ast } from '@kubb/core'
-import { defineParser } from '@kubb/core'
-import { extractStringsFromNodes } from '@kubb/ast/utils'
-
-import { print, type PrintInput } from './utils.ts'
-
-/**
- * Metadata accepted by `parserMd`. Set `frontmatter` on a `<File meta={…}>` to
- * have the parser prepend the corresponding YAML envelope.
- */
-export type MdMeta = {
-  frontmatter?: Record<string, unknown> | null
-}
-
-/**
- * Kubb parser for `.md` and `.markdown` files. Joins source blocks as plain
- * markdown (separated by blank lines) and, when `file.meta.frontmatter` is set,
- * prepends a YAML frontmatter envelope produced by `parserMd.print`.
- *
- * Add to the `parsers` array on `defineConfig` to opt in. `parserTs` keeps
- * handling `.ts`/`.js` files, `parserMd` claims `.md`/`.markdown`.
- *
- * @example
- * ```ts
- * import { defineConfig } from 'kubb'
- * import { adapterOas } from '@kubb/adapter-oas'
- * import { parserMd } from '@kubb/parser-md'
- *
- * export default defineConfig({
- *   input: { path: './petStore.yaml' },
- *   output: { path: './src/gen' },
- *   adapter: adapterOas(),
- *   parsers: [parserMd],
- *   plugins: [],
- * })
- * ```
- */
-export const parserMd = defineParser({
-  name: 'markdown',
-  extNames: ['.md', '.markdown'],
-  print(...parts: Array<PrintInput>) {
-    return print(...parts)
-  },
-  parse(file) {
-    const sourceParts: Array<string> = []
-    for (const source of file.sources) {
-      const text = extractStringsFromNodes(source.nodes as Array<ast.CodeNode>)
-      if (text) sourceParts.push(text.trimEnd())
-    }
-    const body = sourceParts.join('\n\n')
-
-    const meta = file.meta as MdMeta | undefined
-    const frontmatter = print(meta?.frontmatter ?? undefined)
-
-    const parts = [file.banner, frontmatter, body, file.footer].filter((segment): segment is string => Boolean(segment)).map((segment) => segment.trimEnd())
-
-    return parts.join('\n\n')
-  },
-})

package/src/utils.ts

@@ -1,45 +0,0 @@
-import { stringify } from 'yaml'
-
-/**
- * Markdown `print` input, either a markdown text fragment (passed through
- * verbatim) or a plain object that is serialized as a YAML frontmatter envelope.
- */
-export type PrintInput = string | Record<string, unknown>
-
-/**
- * Wraps a plain object as a YAML frontmatter envelope:
- *
- * ```
- * ---
- * <yaml>
- * ---
- * ```
- *
- * Returns an empty string for `null`, `undefined`, or empty objects so callers
- * can drop the result through the same filter chain as banner/footer fields.
- */
-function printFrontmatter(data: Record<string, unknown> | null | undefined): string {
-  if (!data || Object.keys(data).length === 0) return ''
-  return `---\n${stringify(data).trimEnd()}\n---`
-}
-
-/**
- * Joins a list of markdown fragments with blank lines. Plain objects are
- * rendered as YAML frontmatter via {@link printFrontmatter}, and strings pass
- * through unchanged.
- *
- * @example
- * ```ts
- * print({ title: 'Hi' }, '# Hello')
- * // '---\ntitle: Hi\n---\n\n# Hello'
- * ```
- */
-export function print(...parts: Array<PrintInput | null | undefined>): string {
-  const rendered: Array<string> = []
-  for (const part of parts) {
-    if (part === null || part === undefined || part === '') continue
-    const text = typeof part === 'string' ? part : printFrontmatter(part)
-    if (text) rendered.push(text.trimEnd())
-  }
-  return rendered.join('\n\n')
-}