markdown-codec 4.0.14 → 4.1.0

package/dist/lower/lower.js

@@ -1,8 +1,8 @@
 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, MATH_BLOCK_STYLE_ID, QUOTE_STYLE_ID, headingStyleId } from "../shared/style-constants.js";
+import { createNumIdMintState, mintListItemId, 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";
@@ -24,17 +24,21 @@ function decorateParagraph(paragraph, context) {
 	};
 	if (context.list !== void 0) result = {
 		...result,
-		list: {
-			numId: context.list.numId,
-			level: context.list.level
-		}
+		list: { ...context.list }
 	};
 	return result;
 }
+function paragraphWithConstructs(runs, linkTitleExtents) {
+	return {
+		runs,
+		...linkTitleExtents.length > 0 ? { constructs: [...linkTitleExtents] } : {}
+	};
+}
 function lowerHeading(node, context) {
+	const inline = lowerInlineNodes(node.children, inlineContext(context));
 	return [decorateParagraph({
 		kind: "paragraph",
-		runs: lowerInlineNodes(node.children, inlineContext(context)),
+		...paragraphWithConstructs(inline.runs, inline.linkTitleExtents),
 		styleId: headingStyleId(node.level),
 		headingLevel: node.level
 	}, context)];
@@ -45,9 +49,10 @@ function lowerParagraph(node, context) {
 	let segment = [];
 	const flushSegment = (force) => {
 		if (segment.length === 0 && !force) return;
+		const inline = lowerInlineNodes(segment, inlineCtx);
 		blocks.push(decorateParagraph({
 			kind: "paragraph",
-			runs: lowerInlineNodes(segment, inlineCtx)
+			...paragraphWithConstructs(inline.runs, inline.linkTitleExtents)
 		}, context));
 		segment = [];
 	};
@@ -69,39 +74,73 @@ function lowerParagraph(node, context) {
 			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({
+		const image = {
 			kind: "image",
 			format: resolved.format,
 			base64: resolved.base64,
 			widthPt: resolved.widthPt,
 			heightPt: resolved.heightPt,
 			...child.alt.length > 0 ? { altText: child.alt } : {}
-		});
+		};
+		if (child.title === void 0) {
+			blocks.push(image);
+			continue;
+		}
+		blocks.push({
+			kind: "constructStart",
+			descriptor: {
+				kind: "link",
+				target: {
+					kind: "external",
+					uri: child.destination
+				},
+				title: child.title
+			}
+		}, image, { kind: "constructEnd" });
 	}
 	flushSegment(blocks.length === 0);
 	return blocks;
 }
+function splitInfoString(infoString) {
+	const firstWhitespace = infoString.search(/\s/);
+	if (firstWhitespace === -1) return infoString.startsWith("{") ? {
+		language: void 0,
+		remainder: infoString
+	} : {
+		language: infoString,
+		remainder: void 0
+	};
+	const firstWord = infoString.slice(0, firstWhitespace);
+	const remainder = infoString.slice(firstWhitespace).trim();
+	if (firstWord.startsWith("{")) return {
+		language: void 0,
+		remainder: infoString.trim()
+	};
+	return {
+		language: firstWord,
+		remainder: remainder.length > 0 ? remainder : void 0
+	};
+}
 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`
-	});
+	const info = node.fenced && node.infoString !== void 0 && node.infoString.length > 0 ? splitInfoString(node.infoString) : {
+		language: void 0,
+		remainder: void 0
+	};
 	return [decorateParagraph({
 		kind: "paragraph",
 		runs: [lowerCodeBlockRun(node.literal.replace(/\n$/, ""))],
-		styleId: CODE_BLOCK_STYLE_ID
+		styleId: CODE_BLOCK_STYLE_ID,
+		...info.language !== void 0 ? { codeLanguage: info.language } : {},
+		...info.remainder !== void 0 ? { source: {
+			format: "markdown",
+			xml: info.remainder
+		} } : {}
 	}, context)];
 }
 function lowerThematicBreak(context) {
@@ -123,70 +162,95 @@ function lowerHtmlBlock(node, context) {
 	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"
+		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, and its verbatim original rides the paragraph's own markdown residue for this package's writer to re-emit as-is"
 	});
 	const literal = node.literal.replace(/\n+$/, "");
 	return [decorateParagraph({
 		kind: "paragraph",
 		runs: literal.length === 0 ? [] : [{ text: literal }],
-		styleId: HTML_PREFORMATTED_STYLE_ID
+		styleId: HTML_PREFORMATTED_STYLE_ID,
+		source: {
+			format: "markdown",
+			xml: node.literal
+		}
 	}, context)];
 }
 function lowerMathBlock(node, context) {
-	context.sink({
-		code: MarkdownDiagnosticCodes.MATH_BLOCK_PRESERVED_AS_TEXT,
+	if (context.list !== void 0) context.sink({
+		code: MarkdownDiagnosticCodes.LIST_ITEM_BLOCK_UNLISTED,
 		severity: "info",
-		message: "block math ($$...$$) was preserved as literal raw LaTeX text (styleId \"MathBlock\"); it is not parsed as LaTeX or converted to MathML by this package"
+		message: "a display-math 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"
 	});
-	const literal = node.literal.replace(/\n$/, "");
-	return [decorateParagraph({
-		kind: "paragraph",
-		runs: literal.length === 0 ? [] : [{ text: literal }],
-		styleId: MATH_BLOCK_STYLE_ID
-	}, context)];
+	return [{
+		kind: "embeddedObject",
+		objectKind: "formula",
+		document: {
+			kind: "formula",
+			metadata: {},
+			formula: {
+				mathml: [],
+				presentation: { latex: node.literal.replace(/\n$/, "") }
+			}
+		},
+		frame: {
+			xPt: 0,
+			yPt: 0,
+			widthPt: 0,
+			heightPt: 0
+		}
+	}];
+}
+function blockquoteSubtreeContainsHeading(node) {
+	const walk = (block) => {
+		switch (block.type) {
+			case "heading": return true;
+			case "blockquote":
+			case "list":
+			case "listItem": return block.children.some(walk);
+			default: return false;
+		}
+	};
+	return node.children.some(walk);
 }
 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({
+	const inner = blocks.length === 0 ? [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;
+	}, nested)] : blocks;
+	if (blockquoteSubtreeContainsHeading(node)) {
+		context.sink({
+			code: MarkdownDiagnosticCodes.BLOCKQUOTE_CONTAINER_SKIPPED,
+			severity: "info",
+			message: "a blockquote containing a heading cannot carry its division construct -- a marker extent may not open a heading scope, and the last heading inside an extent always leaves one standing -- so this quote degrades to indent-only structure while the heading keeps its heading fidelity"
+		});
+		return inner;
+	}
+	return [
+		{
+			kind: "constructStart",
+			descriptor: { kind: "division" }
+		},
+		...inner,
+		{ kind: "constructEnd" }
+	];
 }
 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 membership = {
+		numId,
+		level,
+		...item.checked !== void 0 ? { checked: item.checked } : {},
+		itemId: mintListItemId(context.numIdState)
+	};
 	const itemContext = {
 		...context,
-		list: {
-			numId,
-			level
-		}
+		list: membership
 	};
 	const blocks = [];
-	let checkboxApplied = item.checked === void 0;
 	let ownLevelBlockCount = 0;
 	for (const child of item.children) {
 		if (child.type === "list") {
@@ -195,17 +259,12 @@ function lowerListItem(item, numId, level, context, contentWidthPt) {
 		}
 		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);
-	}
+	if (ownLevelBlockCount === 0) blocks.unshift(decorateParagraph({
+		kind: "paragraph",
+		runs: []
+	}, itemContext));
 	return blocks;
 }
 function lowerList(node, ancestorNumId, level, context, contentWidthPt) {
@@ -330,15 +389,16 @@ function lowerParsedMarkdown(parsed, options = {}, metadata = {}) {
 		}]
 	};
 }
-function lowerMarkdown(source, options = {}) {
+function lowerMarkdownDetailed(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) : {
+	const extracted = options.frontMatter ?? false ? extractFrontMatter(source, sink) : {
 		metadata: {},
-		rest: source
+		rest: source,
+		source: void 0
 	};
 	const parseOptions = {
 		gfmTables: options.gfmTables,
@@ -349,7 +409,15 @@ function lowerMarkdown(source, options = {}) {
 		maxNesting: options.maxBlockNesting,
 		sink
 	};
-	return lowerParsedMarkdown(parseMarkdown(rest, parseOptions), options, metadata);
+	const parsed = parseMarkdown(extracted.rest, parseOptions);
+	return {
+		document: lowerParsedMarkdown(parsed, options, extracted.metadata),
+		references: parsed.references,
+		frontMatterSource: extracted.source
+	};
+}
+function lowerMarkdown(source, options = {}) {
+	return lowerMarkdownDetailed(source, options).document;
 }
 //#endregion
-export { lowerMarkdown, lowerParsedMarkdown };
+export { lowerMarkdown, lowerMarkdownDetailed, lowerParsedMarkdown };

package/dist/lower/table.cjs

@@ -6,11 +6,12 @@ function toParagraphAlignment(alignment) {
 	return alignment === "none" ? void 0 : alignment;
 }
 function lowerTableCell(cell, alignment, context) {
-	const runs = require_lower_inline.lowerInlineNodes(cell.children, context);
+	const inline = require_lower_inline.lowerInlineNodes(cell.children, context);
 	const paragraphAlignment = toParagraphAlignment(alignment ?? "none");
 	return { blocks: [{
 		kind: "paragraph",
-		runs,
+		runs: inline.runs,
+		...inline.linkTitleExtents.length > 0 ? { constructs: [...inline.linkTitleExtents] } : {},
 		...paragraphAlignment === void 0 ? {} : { alignment: paragraphAlignment }
 	}] };
 }

package/dist/lower/table.js

@@ -5,11 +5,12 @@ function toParagraphAlignment(alignment) {
 	return alignment === "none" ? void 0 : alignment;
 }
 function lowerTableCell(cell, alignment, context) {
-	const runs = lowerInlineNodes(cell.children, context);
+	const inline = lowerInlineNodes(cell.children, context);
 	const paragraphAlignment = toParagraphAlignment(alignment ?? "none");
 	return { blocks: [{
 		kind: "paragraph",
-		runs,
+		runs: inline.runs,
+		...inline.linkTitleExtents.length > 0 ? { constructs: [...inline.linkTitleExtents] } : {},
 		...paragraphAlignment === void 0 ? {} : { alignment: paragraphAlignment }
 	}] };
 }

package/dist/options/options.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
 import { n as MarkdownImageResolver } from "../image-C4KYmz_L.cjs";
 import { Margins, PageSize } from "document-schema.js";
 //#region src/options/options.d.ts

package/dist/options/options.d.ts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-BWK1iGy7.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.js";
 import { n as MarkdownImageResolver } from "../image-Cm3hT5PS.js";
 import { Margins, PageSize } from "document-schema.js";
 //#region src/options/options.d.ts

package/dist/read.cjs

@@ -2,19 +2,12 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_lower_lower = require("./lower/lower.cjs");
 let document_schema_js = require("document-schema.js");
 //#region src/read.ts
-function readMarkdown(text, options = {}) {
-	const { document, diagnostics } = readMarkdownContent(text, options);
-	return {
-		documentPackage: (0, document_schema_js.assemblePackage)(document),
-		diagnostics
-	};
-}
-function readMarkdownContent(text, options = {}) {
+function readMarkdownDetail(text, options) {
 	options.signal?.throwIfAborted();
 	const diagnostics = [];
 	const callerSink = options.sink;
 	return {
-		document: require_lower_lower.lowerMarkdown(text, {
+		...require_lower_lower.lowerMarkdownDetailed(text, {
 			...options,
 			sink: (diagnostic) => {
 				diagnostics.push(diagnostic);
@@ -24,6 +17,49 @@ function readMarkdownContent(text, options = {}) {
 		diagnostics
 	};
 }
+function linkDefinitionEntries(references) {
+	if (references.size === 0) return;
+	const entries = {};
+	for (const [label, definition] of references) entries[label] = definition.title === void 0 ? {
+		kind: "link",
+		destination: definition.destination
+	} : {
+		kind: "link",
+		destination: definition.destination,
+		title: definition.title
+	};
+	return entries;
+}
+function readMarkdown(text, options = {}) {
+	const detail = readMarkdownDetail(text, options);
+	const assembled = (0, document_schema_js.assemblePackage)(detail.document);
+	const definitions = linkDefinitionEntries(detail.references);
+	const frontMatterResidue = detail.frontMatterSource === void 0 ? void 0 : {
+		format: "markdown",
+		xml: detail.frontMatterSource
+	};
+	return {
+		documentPackage: definitions === void 0 && frontMatterResidue === void 0 ? assembled : {
+			...assembled,
+			...definitions !== void 0 ? { definitions: {
+				...assembled.definitions,
+				...definitions
+			} } : {},
+			...frontMatterResidue !== void 0 ? { source: {
+				...assembled.source ?? {},
+				frontmatter: frontMatterResidue
+			} } : {}
+		},
+		diagnostics: detail.diagnostics
+	};
+}
+function readMarkdownContent(text, options = {}) {
+	const detail = readMarkdownDetail(text, options);
+	return {
+		document: detail.document,
+		diagnostics: detail.diagnostics
+	};
+}
 //#endregion
 exports.readMarkdown = readMarkdown;
 exports.readMarkdownContent = readMarkdownContent;

package/dist/read.d.cts

@@ -1,4 +1,4 @@
-import { t as MarkdownDiagnostic } from "./diagnostics-BWK1iGy7.cjs";
+import { t as MarkdownDiagnostic } from "./diagnostics-CUMLtGHJ.cjs";
 import { ReadMarkdownOptions } from "./options/options.cjs";
 import { ContentDocument, DocumentPackage } from "document-schema.js";
 //#region src/read.d.ts

package/dist/read.d.ts

@@ -1,4 +1,4 @@
-import { t as MarkdownDiagnostic } from "./diagnostics-BWK1iGy7.js";
+import { t as MarkdownDiagnostic } from "./diagnostics-CUMLtGHJ.js";
 import { ReadMarkdownOptions } from "./options/options.js";
 import { ContentDocument, DocumentPackage } from "document-schema.js";
 //#region src/read.d.ts

package/dist/read.js

@@ -1,19 +1,12 @@
-import { lowerMarkdown } from "./lower/lower.js";
+import { lowerMarkdownDetailed } from "./lower/lower.js";
 import { assemblePackage } from "document-schema.js";
 //#region src/read.ts
-function readMarkdown(text, options = {}) {
-	const { document, diagnostics } = readMarkdownContent(text, options);
-	return {
-		documentPackage: assemblePackage(document),
-		diagnostics
-	};
-}
-function readMarkdownContent(text, options = {}) {
+function readMarkdownDetail(text, options) {
 	options.signal?.throwIfAborted();
 	const diagnostics = [];
 	const callerSink = options.sink;
 	return {
-		document: lowerMarkdown(text, {
+		...lowerMarkdownDetailed(text, {
 			...options,
 			sink: (diagnostic) => {
 				diagnostics.push(diagnostic);
@@ -23,5 +16,48 @@ function readMarkdownContent(text, options = {}) {
 		diagnostics
 	};
 }
+function linkDefinitionEntries(references) {
+	if (references.size === 0) return;
+	const entries = {};
+	for (const [label, definition] of references) entries[label] = definition.title === void 0 ? {
+		kind: "link",
+		destination: definition.destination
+	} : {
+		kind: "link",
+		destination: definition.destination,
+		title: definition.title
+	};
+	return entries;
+}
+function readMarkdown(text, options = {}) {
+	const detail = readMarkdownDetail(text, options);
+	const assembled = assemblePackage(detail.document);
+	const definitions = linkDefinitionEntries(detail.references);
+	const frontMatterResidue = detail.frontMatterSource === void 0 ? void 0 : {
+		format: "markdown",
+		xml: detail.frontMatterSource
+	};
+	return {
+		documentPackage: definitions === void 0 && frontMatterResidue === void 0 ? assembled : {
+			...assembled,
+			...definitions !== void 0 ? { definitions: {
+				...assembled.definitions,
+				...definitions
+			} } : {},
+			...frontMatterResidue !== void 0 ? { source: {
+				...assembled.source ?? {},
+				frontmatter: frontMatterResidue
+			} } : {}
+		},
+		diagnostics: detail.diagnostics
+	};
+}
+function readMarkdownContent(text, options = {}) {
+	const detail = readMarkdownDetail(text, options);
+	return {
+		document: detail.document,
+		diagnostics: detail.diagnostics
+	};
+}
 //#endregion
 export { readMarkdown, readMarkdownContent };

package/dist/shared/list-id.cjs

@@ -29,8 +29,14 @@ function parseListNumId(numId) {
 function mintedListType(numId) {
 	return parseListNumId(numId)?.type;
 }
+function mintListItemId(state) {
+	const id = state.next;
+	state.next += 1;
+	return `md-i${String(id)}`;
+}
 //#endregion
 exports.createNumIdMintState = createNumIdMintState;
+exports.mintListItemId = mintListItemId;
 exports.mintListNumId = mintListNumId;
 exports.mintedListType = mintedListType;
 exports.parseListNumId = parseListNumId;

package/dist/shared/list-id.d.cts

@@ -18,5 +18,6 @@ declare function createNumIdMintState(): NumIdMintState;
 declare function mintListNumId(state: NumIdMintState, options: ListNumIdMintOptions): string;
 declare function parseListNumId(numId: string): ListNumIdInfo | undefined;
 declare function mintedListType(numId: string): 'bullet' | 'ordered' | undefined;
+declare function mintListItemId(state: NumIdMintState): string;
 //#endregion
-export { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListNumId, mintedListType, parseListNumId };
+export { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListItemId, mintListNumId, mintedListType, parseListNumId };

package/dist/shared/list-id.d.ts

@@ -18,5 +18,6 @@ declare function createNumIdMintState(): NumIdMintState;
 declare function mintListNumId(state: NumIdMintState, options: ListNumIdMintOptions): string;
 declare function parseListNumId(numId: string): ListNumIdInfo | undefined;
 declare function mintedListType(numId: string): 'bullet' | 'ordered' | undefined;
+declare function mintListItemId(state: NumIdMintState): string;
 //#endregion
-export { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListNumId, mintedListType, parseListNumId };
+export { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListItemId, mintListNumId, mintedListType, parseListNumId };

package/dist/shared/list-id.js

@@ -28,5 +28,10 @@ function parseListNumId(numId) {
 function mintedListType(numId) {
 	return parseListNumId(numId)?.type;
 }
+function mintListItemId(state) {
+	const id = state.next;
+	state.next += 1;
+	return `md-i${String(id)}`;
+}
 //#endregion
-export { createNumIdMintState, mintListNumId, mintedListType, parseListNumId };
+export { createNumIdMintState, mintListItemId, mintListNumId, mintedListType, parseListNumId };

package/dist/write.cjs

@@ -1,11 +1,29 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_diagnostics_diagnostics = require("./diagnostics/diagnostics.cjs");
+const require_emit_front_matter = require("./emit/front-matter.cjs");
+const require_emit_inline = require("./emit/inline.cjs");
 const require_emit_emit = require("./emit/emit.cjs");
 let document_schema_js = require("document-schema.js");
 //#region src/write.ts
-function reportDroppedPackageTables(documentPackage, sink) {
+function renderLinkDefinition(label, entry) {
+	const destination = entry.destination;
+	const title = entry.title;
+	if (typeof destination !== "string") return;
+	if (title !== void 0 && typeof title !== "string") return;
+	return `[${label}]: ${require_emit_inline.escapeLinkDestination(destination)}${title === void 0 ? "" : ` "${require_emit_inline.renderLinkTitle(title)}"`}`;
+}
+function renderLinkDefinitions(definitions) {
+	const lines = [];
+	for (const [label, entry] of Object.entries(definitions)) {
+		const line = renderLinkDefinition(label, entry);
+		if (line !== void 0) lines.push(line);
+	}
+	return lines.length > 0 ? lines.join("\n") : void 0;
+}
+function reportDroppedPackageTables(documentPackage, definitionsRendered, sink) {
+	const definitions = documentPackage.definitions;
 	const tables = [
-		["definitions", documentPackage.definitions !== void 0 && Object.keys(documentPackage.definitions).length > 0],
+		["definitions", definitions !== void 0 && !definitionsRendered && Object.keys(definitions).length > 0],
 		["layers", documentPackage.layers !== void 0 && Object.keys(documentPackage.layers).length > 0],
 		["attachments", documentPackage.attachments !== void 0 && Object.keys(documentPackage.attachments).length > 0],
 		["destinations", documentPackage.destinations !== void 0 && Object.keys(documentPackage.destinations).length > 0],
@@ -23,14 +41,23 @@ function reportDroppedPackageTables(documentPackage, sink) {
 function writeMarkdown(documentPackage, options = {}) {
 	options.signal?.throwIfAborted();
 	if (documentPackage.kind !== "wordprocessing") throw new require_diagnostics_diagnostics.MarkdownUnsupportedDocumentKindError(documentPackage.kind);
-	reportDroppedPackageTables(documentPackage, options.sink ?? require_diagnostics_diagnostics.NOOP_MARKDOWN_DIAGNOSTIC_SINK);
+	const sink = options.sink ?? require_diagnostics_diagnostics.NOOP_MARKDOWN_DIAGNOSTIC_SINK;
+	const definitionsBlock = documentPackage.definitions === void 0 ? void 0 : renderLinkDefinitions(documentPackage.definitions);
+	reportDroppedPackageTables(documentPackage, definitionsBlock !== void 0, sink);
 	let flattened;
 	try {
 		flattened = (0, document_schema_js.flattenPackage)(documentPackage);
 	} catch (error) {
 		throw new require_diagnostics_diagnostics.MarkdownPackageFlattenError(error);
 	}
-	return writeMarkdownContent(flattened, options);
+	const body = writeMarkdownContent(flattened, {
+		...options,
+		frontMatter: false
+	});
+	const frontMatterResidue = documentPackage.source?.frontmatter;
+	const frontMatter = options.frontMatter === true ? frontMatterResidue?.format === "markdown" ? frontMatterResidue.xml : require_emit_front_matter.emitFrontMatter(flattened.metadata) : void 0;
+	const withFrontMatter = frontMatter === void 0 ? body : `${frontMatter}\n\n${body}`;
+	return definitionsBlock === void 0 ? withFrontMatter : withFrontMatter.length > 0 ? `${withFrontMatter}\n\n${definitionsBlock}` : definitionsBlock;
 }
 function writeMarkdownContent(document, options = {}) {
 	options.signal?.throwIfAborted();