markdown-codec 0.0.0 → 1.0.0

package/dist/lower/inline.js

@@ -0,0 +1,93 @@
+import { MarkdownDiagnosticCodes } from "../diagnostics/diagnostics.js";
+import { MONOSPACE_FONT_FAMILY } from "../shared/style-constants.js";
+//#region src/lower/inline.ts
+function buildRun(text, style, fontFamily) {
+	return {
+		text,
+		...style.bold === true ? { bold: true } : {},
+		...style.italic === true ? { italic: true } : {},
+		...style.strike === true ? { strike: true } : {},
+		...style.hyperlink !== void 0 ? { hyperlink: style.hyperlink } : {},
+		...fontFamily !== void 0 ? { fontFamily } : {}
+	};
+}
+function lowerNestedEmphasisLike(kind, node, style, context) {
+	if (style[kind] === true) context.sink({
+		code: MarkdownDiagnosticCodes.NESTED_EMPHASIS_FLATTENED,
+		severity: "info",
+		message: `a ${kind === "italic" ? "emphasis" : kind === "bold" ? "strong emphasis" : "strikethrough"} span is nested inside another span of the same kind; ContentRun has no nesting depth of its own, so both collapse to one flat run`
+	});
+	const childStyle = {
+		...style,
+		[kind]: true
+	};
+	return node.children.flatMap((child) => lowerInlineNode(child, childStyle, context));
+}
+function lowerInlineNode(node, style, context) {
+	switch (node.type) {
+		case "text": return node.value.length === 0 ? [] : [buildRun(node.value, style)];
+		case "entity": return node.value.length === 0 ? [] : [buildRun(node.value, style)];
+		case "softBreak": return [buildRun(" ", style)];
+		case "hardBreak": return [buildRun("\n", style)];
+		case "codeSpan": return [buildRun(node.literal, style, MONOSPACE_FONT_FAMILY)];
+		case "rawHtml":
+			if (context.rawHtml === "drop") {
+				context.sink({
+					code: MarkdownDiagnosticCodes.RAW_HTML_DROPPED,
+					severity: "info",
+					message: "inline raw HTML was dropped per the rawHtml: \"drop\" option"
+				});
+				return [];
+			}
+			context.sink({
+				code: MarkdownDiagnosticCodes.RAW_HTML_PRESERVED_AS_TEXT,
+				severity: "info",
+				message: "inline raw HTML was preserved as literal text; it will not be rendered as HTML by any consumer of the resulting ContentDocument"
+			});
+			return node.literal.length === 0 ? [] : [buildRun(node.literal, style)];
+		case "autolink": {
+			const destination = node.email ? `mailto:${node.destination}` : node.destination;
+			return [buildRun(node.destination, {
+				...style,
+				hyperlink: destination
+			})];
+		}
+		case "link": {
+			if (node.title !== void 0) context.sink({
+				code: MarkdownDiagnosticCodes.LINK_TITLE_DROPPED,
+				severity: "info",
+				message: `link title "${node.title}" has no ContentRun equivalent and was dropped`
+			});
+			const childStyle = {
+				...style,
+				hyperlink: node.destination
+			};
+			const runs = node.children.flatMap((child) => lowerInlineNode(child, childStyle, context));
+			return runs.length > 0 ? runs : [buildRun("", childStyle)];
+		}
+		case "image":
+			if (node.title !== void 0) context.sink({
+				code: MarkdownDiagnosticCodes.LINK_TITLE_DROPPED,
+				severity: "info",
+				message: `image title "${node.title}" has no ContentRun equivalent and was dropped`
+			});
+			return [buildRun(node.alt, {
+				...style,
+				hyperlink: node.destination
+			})];
+		case "emphasis": return lowerNestedEmphasisLike("italic", node, style, context);
+		case "strong": return lowerNestedEmphasisLike("bold", node, style, context);
+		case "strikethrough": return lowerNestedEmphasisLike("strike", node, style, context);
+	}
+}
+function lowerInlineNodes(nodes, context) {
+	return nodes.flatMap((node) => lowerInlineNode(node, {}, context));
+}
+function lowerCodeBlockRun(literal) {
+	return {
+		text: literal,
+		fontFamily: MONOSPACE_FONT_FAMILY
+	};
+}
+//#endregion
+export { lowerCodeBlockRun, lowerInlineNode, lowerInlineNodes };

package/dist/lower/lower.cjs

@@ -0,0 +1,293 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_defaults_defaults = require("../defaults/defaults.cjs");
+const require_diagnostics_diagnostics = require("../diagnostics/diagnostics.cjs");
+const require_block_block = require("../block/block.cjs");
+const require_shared_list_id = require("../shared/list-id.cjs");
+const require_shared_style_constants = require("../shared/style-constants.cjs");
+const require_lower_front_matter = require("./front-matter.cjs");
+const require_lower_image = require("./image.cjs");
+const require_lower_inline = require("./inline.cjs");
+const require_lower_table = require("./table.cjs");
+let document_schema_js = require("document-schema.js");
+//#region src/lower/lower.ts
+function inlineContext(context) {
+	return {
+		sink: context.sink,
+		rawHtml: context.rawHtmlMode
+	};
+}
+function decorateParagraph(paragraph, context) {
+	let result = paragraph;
+	if (context.quoteDepth > 0) result = {
+		...result,
+		indentLeftPt: context.quoteDepth * 36,
+		...result.styleId === void 0 ? { styleId: require_shared_style_constants.QUOTE_STYLE_ID } : {}
+	};
+	if (context.list !== void 0) result = {
+		...result,
+		list: {
+			numId: context.list.numId,
+			level: context.list.level
+		}
+	};
+	return result;
+}
+function lowerHeading(node, context) {
+	return [decorateParagraph({
+		kind: "paragraph",
+		runs: require_lower_inline.lowerInlineNodes(node.children, inlineContext(context)),
+		styleId: require_shared_style_constants.headingStyleId(node.level)
+	}, context)];
+}
+function lowerParagraph(node, context) {
+	const blocks = [];
+	const inlineCtx = inlineContext(context);
+	let segment = [];
+	const flushSegment = (force) => {
+		if (segment.length === 0 && !force) return;
+		blocks.push(decorateParagraph({
+			kind: "paragraph",
+			runs: require_lower_inline.lowerInlineNodes(segment, inlineCtx)
+		}, context));
+		segment = [];
+	};
+	for (const child of node.children) {
+		if (child.type !== "image") {
+			segment.push(child);
+			continue;
+		}
+		const resolved = require_lower_image.resolveMarkdownImage(child.destination, {
+			alt: child.alt,
+			title: child.title
+		}, context.images);
+		if (resolved === void 0) {
+			context.sink({
+				code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.IMAGE_UNRESOLVED,
+				severity: "info",
+				message: `image "${child.destination}" could not be resolved to real bytes; it degrades to a text run of its own alt text, hyperlinked at its own destination`
+			});
+			segment.push(child);
+			continue;
+		}
+		if (child.title !== void 0) context.sink({
+			code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.LINK_TITLE_DROPPED,
+			severity: "info",
+			message: `image title "${child.title}" has no ContentImageBlock equivalent and was dropped`
+		});
+		flushSegment(false);
+		if (context.list !== void 0) context.sink({
+			code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.LIST_ITEM_BLOCK_UNLISTED,
+			severity: "info",
+			message: "a resolved image block directly inside a list item has no ContentListMembership field of its own -- only ContentParagraph carries .list -- so its association with the enclosing list item is lost"
+		});
+		blocks.push({
+			kind: "image",
+			format: resolved.format,
+			base64: resolved.base64,
+			widthPt: resolved.widthPt,
+			heightPt: resolved.heightPt,
+			...child.alt.length > 0 ? { altText: child.alt } : {}
+		});
+	}
+	flushSegment(blocks.length === 0);
+	return blocks;
+}
+function lowerCodeBlock(node, context) {
+	if (node.fenced && node.infoString !== void 0 && node.infoString.length > 0) context.sink({
+		code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.CODE_BLOCK_INFO_STRING_DROPPED,
+		severity: "info",
+		message: `fenced code block's own info string "${node.infoString}" has no ContentParagraph equivalent and was dropped`
+	});
+	return [decorateParagraph({
+		kind: "paragraph",
+		runs: [require_lower_inline.lowerCodeBlockRun(node.literal.replace(/\n$/, ""))],
+		styleId: require_shared_style_constants.CODE_BLOCK_STYLE_ID
+	}, context)];
+}
+function lowerThematicBreak(context) {
+	return [decorateParagraph({
+		kind: "paragraph",
+		runs: [],
+		styleId: require_shared_style_constants.HORIZONTAL_RULE_STYLE_ID
+	}, context)];
+}
+function lowerHtmlBlock(node, context) {
+	if (context.rawHtmlMode === "drop") {
+		context.sink({
+			code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.RAW_HTML_DROPPED,
+			severity: "info",
+			message: "block-level raw HTML was dropped per the rawHtml: \"drop\" option"
+		});
+		return [];
+	}
+	context.sink({
+		code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.RAW_HTML_PRESERVED_AS_TEXT,
+		severity: "info",
+		message: "block-level raw HTML was preserved as literal text (styleId \"HTMLPreformatted\"); it will not be rendered as HTML by any consumer of the resulting ContentDocument"
+	});
+	const literal = node.literal.replace(/\n+$/, "");
+	return [decorateParagraph({
+		kind: "paragraph",
+		runs: literal.length === 0 ? [] : [{ text: literal }],
+		styleId: require_shared_style_constants.HTML_PREFORMATTED_STYLE_ID
+	}, context)];
+}
+function lowerBlockquote(node, context, contentWidthPt) {
+	if (context.quoteDepth >= 1) context.sink({
+		code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.BLOCKQUOTE_NESTED_DEPTH,
+		severity: "info",
+		message: `blockquote nesting beyond level 1 is represented only as a larger indentLeftPt (${String((context.quoteDepth + 1) * 36)}pt); recovering the exact nesting depth back out is an approximation, not an exact inverse`
+	});
+	const nested = {
+		...context,
+		quoteDepth: context.quoteDepth + 1
+	};
+	const blocks = node.children.flatMap((child) => lowerBlock(child, nested, contentWidthPt));
+	if (blocks.length === 0) return [decorateParagraph({
+		kind: "paragraph",
+		runs: []
+	}, nested)];
+	return blocks;
+}
+function applyTaskCheckbox(blocks, checked) {
+	const first = blocks[0];
+	if (first?.kind !== "paragraph") return false;
+	const checkboxRun = { text: `${checked ? "☒" : "☐"} ` };
+	blocks[0] = {
+		...first,
+		runs: [checkboxRun, ...first.runs]
+	};
+	return true;
+}
+function lowerListItem(item, numId, level, context, contentWidthPt) {
+	if (item.children.filter((child) => child.type !== "list").length > 1) context.sink({
+		code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.LIST_ITEM_MULTI_BLOCK_FLATTENED,
+		severity: "info",
+		message: "a list item directly containing more than one block loses its own item boundary once lowered -- ContentListMembership carries only numId/level, with no field distinguishing \"one item, several blocks\" from \"several items sharing this numId/level\""
+	});
+	const itemContext = {
+		...context,
+		list: {
+			numId,
+			level
+		}
+	};
+	const blocks = [];
+	let checkboxApplied = item.checked === void 0;
+	let ownLevelBlockCount = 0;
+	for (const child of item.children) {
+		if (child.type === "list") {
+			blocks.push(...lowerList(child, numId, level + 1, context, contentWidthPt));
+			continue;
+		}
+		const childBlocks = lowerBlock(child, itemContext, contentWidthPt);
+		ownLevelBlockCount += childBlocks.length;
+		if (!checkboxApplied) checkboxApplied = applyTaskCheckbox(childBlocks, item.checked === true);
+		blocks.push(...childBlocks);
+	}
+	if (ownLevelBlockCount === 0) {
+		const placeholder = [decorateParagraph({
+			kind: "paragraph",
+			runs: []
+		}, itemContext)];
+		if (!checkboxApplied) applyTaskCheckbox(placeholder, item.checked === true);
+		blocks.unshift(...placeholder);
+	}
+	return blocks;
+}
+function lowerList(node, ancestorNumId, level, context, contentWidthPt) {
+	let numId;
+	if (ancestorNumId === void 0) {
+		const task = node.children.some((item) => item.checked !== void 0);
+		numId = require_shared_list_id.mintListNumId(context.numIdState, {
+			type: node.markerType,
+			start: node.start,
+			task,
+			loose: !node.tight
+		});
+	} else {
+		numId = ancestorNumId;
+		const mintedType = require_shared_list_id.mintedListType(numId);
+		if (mintedType !== void 0 && mintedType !== node.markerType) context.sink({
+			code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.LIST_MARKER_TYPE_CONFLICT,
+			severity: "warning",
+			message: `a nested ${node.markerType} list sits under a list minted as ${mintedType}; the enclosing list's own marker type is kept (first-wins) and this nested list's own type is not separately represented`
+		});
+	}
+	return node.children.flatMap((item) => lowerListItem(item, numId, level, context, contentWidthPt));
+}
+function lowerBlock(node, context, contentWidthPt) {
+	switch (node.type) {
+		case "paragraph": return lowerParagraph(node, context);
+		case "heading": return lowerHeading(node, context);
+		case "blockquote": return lowerBlockquote(node, context, contentWidthPt);
+		case "list": return lowerList(node, void 0, 0, context, contentWidthPt);
+		case "codeBlock": return lowerCodeBlock(node, context);
+		case "thematicBreak": return lowerThematicBreak(context);
+		case "htmlBlock": return lowerHtmlBlock(node, context);
+		case "table":
+			if (context.list !== void 0) context.sink({
+				code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.LIST_ITEM_BLOCK_UNLISTED,
+				severity: "info",
+				message: "a table directly inside a list item has no ContentListMembership field of its own -- only ContentParagraph carries .list -- so its association with the enclosing list item is lost"
+			});
+			return [require_lower_table.lowerTable(node, contentWidthPt, inlineContext(context))];
+		case "document":
+		case "listItem":
+		case "tableRow":
+		case "tableCell": return [];
+	}
+}
+function lowerParsedMarkdown(parsed, options = {}, metadata = {}) {
+	const sink = options.sink ?? require_diagnostics_diagnostics.NOOP_MARKDOWN_DIAGNOSTIC_SINK;
+	sink({
+		code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.INVENTED_PAGE_GEOMETRY,
+		severity: "info",
+		message: "markdown carries no page geometry of its own; the resulting ContentSection uses a synthesised page size and margins (ReadMarkdownOptions.pageSize/margins, or document-schema.js's own PAGE_SIZE_A4 default)"
+	});
+	const pageSize = options.pageSize ?? document_schema_js.PAGE_SIZE_A4;
+	const margins = options.margins ?? require_defaults_defaults.DEFAULT_MARGINS;
+	const contentWidthPt = pageSize.widthPt - margins.leftPt - margins.rightPt;
+	const context = {
+		sink,
+		images: options.images,
+		rawHtmlMode: options.rawHtml ?? "preserve",
+		numIdState: require_shared_list_id.createNumIdMintState(),
+		quoteDepth: 0,
+		list: void 0
+	};
+	const blocks = parsed.document.children.flatMap((child) => lowerBlock(child, context, contentWidthPt));
+	return {
+		kind: "wordprocessing",
+		formatVersion: document_schema_js.CONTENT_FORMAT_VERSION,
+		metadata,
+		sections: [{
+			pageSize,
+			margins,
+			blocks
+		}]
+	};
+}
+function lowerMarkdown(source, options = {}) {
+	if (options.maxInputBytes !== void 0) {
+		const actualBytes = new TextEncoder().encode(source).length;
+		if (actualBytes > options.maxInputBytes) throw new require_diagnostics_diagnostics.MarkdownInputTooLargeError(options.maxInputBytes, actualBytes);
+	}
+	const sink = options.sink ?? require_diagnostics_diagnostics.NOOP_MARKDOWN_DIAGNOSTIC_SINK;
+	const { metadata, rest } = options.frontMatter ?? false ? require_lower_front_matter.extractFrontMatter(source, sink) : {
+		metadata: {},
+		rest: source
+	};
+	const parseOptions = {
+		gfmTables: options.gfmTables,
+		gfmAutolinks: options.gfmAutolinks,
+		gfmStrikethrough: options.gfmStrikethrough,
+		gfmTaskLists: options.gfmTaskLists,
+		maxNesting: options.maxBlockNesting,
+		sink
+	};
+	return lowerParsedMarkdown(require_block_block.parseMarkdown(rest, parseOptions), options, metadata);
+}
+//#endregion
+exports.lowerMarkdown = lowerMarkdown;
+exports.lowerParsedMarkdown = lowerParsedMarkdown;

package/dist/lower/lower.d.cts

@@ -0,0 +1,8 @@
+import { ParsedMarkdown } from "../block/block.cjs";
+import { ReadMarkdownOptions } from "../options/options.cjs";
+import { ContentDocument, LayoutMetadata } from "document-schema.js";
+//#region src/lower/lower.d.ts
+declare function lowerParsedMarkdown(parsed: ParsedMarkdown, options?: ReadMarkdownOptions, metadata?: LayoutMetadata): ContentDocument;
+declare function lowerMarkdown(source: string, options?: ReadMarkdownOptions): ContentDocument;
+//#endregion
+export { lowerMarkdown, lowerParsedMarkdown };

package/dist/lower/lower.d.ts

@@ -0,0 +1,8 @@
+import { ParsedMarkdown } from "../block/block.js";
+import { ReadMarkdownOptions } from "../options/options.js";
+import { ContentDocument, LayoutMetadata } from "document-schema.js";
+//#region src/lower/lower.d.ts
+declare function lowerParsedMarkdown(parsed: ParsedMarkdown, options?: ReadMarkdownOptions, metadata?: LayoutMetadata): ContentDocument;
+declare function lowerMarkdown(source: string, options?: ReadMarkdownOptions): ContentDocument;
+//#endregion
+export { lowerMarkdown, lowerParsedMarkdown };

package/dist/lower/lower.js

@@ -0,0 +1,291 @@
+import { DEFAULT_MARGINS } from "../defaults/defaults.js";
+import { MarkdownDiagnosticCodes, MarkdownInputTooLargeError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "../diagnostics/diagnostics.js";
+import { parseMarkdown } from "../block/block.js";
+import { createNumIdMintState, mintListNumId, mintedListType } from "../shared/list-id.js";
+import { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, QUOTE_STYLE_ID, headingStyleId } from "../shared/style-constants.js";
+import { extractFrontMatter } from "./front-matter.js";
+import { resolveMarkdownImage } from "./image.js";
+import { lowerCodeBlockRun, lowerInlineNodes } from "./inline.js";
+import { lowerTable } from "./table.js";
+import { CONTENT_FORMAT_VERSION, PAGE_SIZE_A4 } from "document-schema.js";
+//#region src/lower/lower.ts
+function inlineContext(context) {
+	return {
+		sink: context.sink,
+		rawHtml: context.rawHtmlMode
+	};
+}
+function decorateParagraph(paragraph, context) {
+	let result = paragraph;
+	if (context.quoteDepth > 0) result = {
+		...result,
+		indentLeftPt: context.quoteDepth * 36,
+		...result.styleId === void 0 ? { styleId: QUOTE_STYLE_ID } : {}
+	};
+	if (context.list !== void 0) result = {
+		...result,
+		list: {
+			numId: context.list.numId,
+			level: context.list.level
+		}
+	};
+	return result;
+}
+function lowerHeading(node, context) {
+	return [decorateParagraph({
+		kind: "paragraph",
+		runs: lowerInlineNodes(node.children, inlineContext(context)),
+		styleId: headingStyleId(node.level)
+	}, context)];
+}
+function lowerParagraph(node, context) {
+	const blocks = [];
+	const inlineCtx = inlineContext(context);
+	let segment = [];
+	const flushSegment = (force) => {
+		if (segment.length === 0 && !force) return;
+		blocks.push(decorateParagraph({
+			kind: "paragraph",
+			runs: lowerInlineNodes(segment, inlineCtx)
+		}, context));
+		segment = [];
+	};
+	for (const child of node.children) {
+		if (child.type !== "image") {
+			segment.push(child);
+			continue;
+		}
+		const resolved = resolveMarkdownImage(child.destination, {
+			alt: child.alt,
+			title: child.title
+		}, context.images);
+		if (resolved === void 0) {
+			context.sink({
+				code: MarkdownDiagnosticCodes.IMAGE_UNRESOLVED,
+				severity: "info",
+				message: `image "${child.destination}" could not be resolved to real bytes; it degrades to a text run of its own alt text, hyperlinked at its own destination`
+			});
+			segment.push(child);
+			continue;
+		}
+		if (child.title !== void 0) context.sink({
+			code: MarkdownDiagnosticCodes.LINK_TITLE_DROPPED,
+			severity: "info",
+			message: `image title "${child.title}" has no ContentImageBlock equivalent and was dropped`
+		});
+		flushSegment(false);
+		if (context.list !== void 0) context.sink({
+			code: MarkdownDiagnosticCodes.LIST_ITEM_BLOCK_UNLISTED,
+			severity: "info",
+			message: "a resolved image block directly inside a list item has no ContentListMembership field of its own -- only ContentParagraph carries .list -- so its association with the enclosing list item is lost"
+		});
+		blocks.push({
+			kind: "image",
+			format: resolved.format,
+			base64: resolved.base64,
+			widthPt: resolved.widthPt,
+			heightPt: resolved.heightPt,
+			...child.alt.length > 0 ? { altText: child.alt } : {}
+		});
+	}
+	flushSegment(blocks.length === 0);
+	return blocks;
+}
+function lowerCodeBlock(node, context) {
+	if (node.fenced && node.infoString !== void 0 && node.infoString.length > 0) context.sink({
+		code: MarkdownDiagnosticCodes.CODE_BLOCK_INFO_STRING_DROPPED,
+		severity: "info",
+		message: `fenced code block's own info string "${node.infoString}" has no ContentParagraph equivalent and was dropped`
+	});
+	return [decorateParagraph({
+		kind: "paragraph",
+		runs: [lowerCodeBlockRun(node.literal.replace(/\n$/, ""))],
+		styleId: CODE_BLOCK_STYLE_ID
+	}, context)];
+}
+function lowerThematicBreak(context) {
+	return [decorateParagraph({
+		kind: "paragraph",
+		runs: [],
+		styleId: HORIZONTAL_RULE_STYLE_ID
+	}, context)];
+}
+function lowerHtmlBlock(node, context) {
+	if (context.rawHtmlMode === "drop") {
+		context.sink({
+			code: MarkdownDiagnosticCodes.RAW_HTML_DROPPED,
+			severity: "info",
+			message: "block-level raw HTML was dropped per the rawHtml: \"drop\" option"
+		});
+		return [];
+	}
+	context.sink({
+		code: MarkdownDiagnosticCodes.RAW_HTML_PRESERVED_AS_TEXT,
+		severity: "info",
+		message: "block-level raw HTML was preserved as literal text (styleId \"HTMLPreformatted\"); it will not be rendered as HTML by any consumer of the resulting ContentDocument"
+	});
+	const literal = node.literal.replace(/\n+$/, "");
+	return [decorateParagraph({
+		kind: "paragraph",
+		runs: literal.length === 0 ? [] : [{ text: literal }],
+		styleId: HTML_PREFORMATTED_STYLE_ID
+	}, context)];
+}
+function lowerBlockquote(node, context, contentWidthPt) {
+	if (context.quoteDepth >= 1) context.sink({
+		code: MarkdownDiagnosticCodes.BLOCKQUOTE_NESTED_DEPTH,
+		severity: "info",
+		message: `blockquote nesting beyond level 1 is represented only as a larger indentLeftPt (${String((context.quoteDepth + 1) * 36)}pt); recovering the exact nesting depth back out is an approximation, not an exact inverse`
+	});
+	const nested = {
+		...context,
+		quoteDepth: context.quoteDepth + 1
+	};
+	const blocks = node.children.flatMap((child) => lowerBlock(child, nested, contentWidthPt));
+	if (blocks.length === 0) return [decorateParagraph({
+		kind: "paragraph",
+		runs: []
+	}, nested)];
+	return blocks;
+}
+function applyTaskCheckbox(blocks, checked) {
+	const first = blocks[0];
+	if (first?.kind !== "paragraph") return false;
+	const checkboxRun = { text: `${checked ? "☒" : "☐"} ` };
+	blocks[0] = {
+		...first,
+		runs: [checkboxRun, ...first.runs]
+	};
+	return true;
+}
+function lowerListItem(item, numId, level, context, contentWidthPt) {
+	if (item.children.filter((child) => child.type !== "list").length > 1) context.sink({
+		code: MarkdownDiagnosticCodes.LIST_ITEM_MULTI_BLOCK_FLATTENED,
+		severity: "info",
+		message: "a list item directly containing more than one block loses its own item boundary once lowered -- ContentListMembership carries only numId/level, with no field distinguishing \"one item, several blocks\" from \"several items sharing this numId/level\""
+	});
+	const itemContext = {
+		...context,
+		list: {
+			numId,
+			level
+		}
+	};
+	const blocks = [];
+	let checkboxApplied = item.checked === void 0;
+	let ownLevelBlockCount = 0;
+	for (const child of item.children) {
+		if (child.type === "list") {
+			blocks.push(...lowerList(child, numId, level + 1, context, contentWidthPt));
+			continue;
+		}
+		const childBlocks = lowerBlock(child, itemContext, contentWidthPt);
+		ownLevelBlockCount += childBlocks.length;
+		if (!checkboxApplied) checkboxApplied = applyTaskCheckbox(childBlocks, item.checked === true);
+		blocks.push(...childBlocks);
+	}
+	if (ownLevelBlockCount === 0) {
+		const placeholder = [decorateParagraph({
+			kind: "paragraph",
+			runs: []
+		}, itemContext)];
+		if (!checkboxApplied) applyTaskCheckbox(placeholder, item.checked === true);
+		blocks.unshift(...placeholder);
+	}
+	return blocks;
+}
+function lowerList(node, ancestorNumId, level, context, contentWidthPt) {
+	let numId;
+	if (ancestorNumId === void 0) {
+		const task = node.children.some((item) => item.checked !== void 0);
+		numId = mintListNumId(context.numIdState, {
+			type: node.markerType,
+			start: node.start,
+			task,
+			loose: !node.tight
+		});
+	} else {
+		numId = ancestorNumId;
+		const mintedType = mintedListType(numId);
+		if (mintedType !== void 0 && mintedType !== node.markerType) context.sink({
+			code: MarkdownDiagnosticCodes.LIST_MARKER_TYPE_CONFLICT,
+			severity: "warning",
+			message: `a nested ${node.markerType} list sits under a list minted as ${mintedType}; the enclosing list's own marker type is kept (first-wins) and this nested list's own type is not separately represented`
+		});
+	}
+	return node.children.flatMap((item) => lowerListItem(item, numId, level, context, contentWidthPt));
+}
+function lowerBlock(node, context, contentWidthPt) {
+	switch (node.type) {
+		case "paragraph": return lowerParagraph(node, context);
+		case "heading": return lowerHeading(node, context);
+		case "blockquote": return lowerBlockquote(node, context, contentWidthPt);
+		case "list": return lowerList(node, void 0, 0, context, contentWidthPt);
+		case "codeBlock": return lowerCodeBlock(node, context);
+		case "thematicBreak": return lowerThematicBreak(context);
+		case "htmlBlock": return lowerHtmlBlock(node, context);
+		case "table":
+			if (context.list !== void 0) context.sink({
+				code: MarkdownDiagnosticCodes.LIST_ITEM_BLOCK_UNLISTED,
+				severity: "info",
+				message: "a table directly inside a list item has no ContentListMembership field of its own -- only ContentParagraph carries .list -- so its association with the enclosing list item is lost"
+			});
+			return [lowerTable(node, contentWidthPt, inlineContext(context))];
+		case "document":
+		case "listItem":
+		case "tableRow":
+		case "tableCell": return [];
+	}
+}
+function lowerParsedMarkdown(parsed, options = {}, metadata = {}) {
+	const sink = options.sink ?? NOOP_MARKDOWN_DIAGNOSTIC_SINK;
+	sink({
+		code: MarkdownDiagnosticCodes.INVENTED_PAGE_GEOMETRY,
+		severity: "info",
+		message: "markdown carries no page geometry of its own; the resulting ContentSection uses a synthesised page size and margins (ReadMarkdownOptions.pageSize/margins, or document-schema.js's own PAGE_SIZE_A4 default)"
+	});
+	const pageSize = options.pageSize ?? PAGE_SIZE_A4;
+	const margins = options.margins ?? DEFAULT_MARGINS;
+	const contentWidthPt = pageSize.widthPt - margins.leftPt - margins.rightPt;
+	const context = {
+		sink,
+		images: options.images,
+		rawHtmlMode: options.rawHtml ?? "preserve",
+		numIdState: createNumIdMintState(),
+		quoteDepth: 0,
+		list: void 0
+	};
+	const blocks = parsed.document.children.flatMap((child) => lowerBlock(child, context, contentWidthPt));
+	return {
+		kind: "wordprocessing",
+		formatVersion: CONTENT_FORMAT_VERSION,
+		metadata,
+		sections: [{
+			pageSize,
+			margins,
+			blocks
+		}]
+	};
+}
+function lowerMarkdown(source, options = {}) {
+	if (options.maxInputBytes !== void 0) {
+		const actualBytes = new TextEncoder().encode(source).length;
+		if (actualBytes > options.maxInputBytes) throw new MarkdownInputTooLargeError(options.maxInputBytes, actualBytes);
+	}
+	const sink = options.sink ?? NOOP_MARKDOWN_DIAGNOSTIC_SINK;
+	const { metadata, rest } = options.frontMatter ?? false ? extractFrontMatter(source, sink) : {
+		metadata: {},
+		rest: source
+	};
+	const parseOptions = {
+		gfmTables: options.gfmTables,
+		gfmAutolinks: options.gfmAutolinks,
+		gfmStrikethrough: options.gfmStrikethrough,
+		gfmTaskLists: options.gfmTaskLists,
+		maxNesting: options.maxBlockNesting,
+		sink
+	};
+	return lowerParsedMarkdown(parseMarkdown(rest, parseOptions), options, metadata);
+}
+//#endregion
+export { lowerMarkdown, lowerParsedMarkdown };