markdown-codec 3.0.0 → 3.1.0

package/dist/block/block.js

@@ -1,3 +1,4 @@
+import { matchFootnoteDefinitionMarker } from "../inline/footnote.js";
 import "../defaults/defaults.js";
 import { MarkdownDiagnosticCodes, MarkdownNestingLimitExceededError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "../diagnostics/diagnostics.js";
 import { matchHtmlBlockStart, matchesHtmlBlockEnd } from "../html/html.js";
@@ -13,7 +14,7 @@ const TASK_LIST_MARKER_PATTERN = /^\[([ xX])\][ \t]/;
 const NUL_REPLACEMENT = "�";
 const NUL_PATTERN = /\0/g;
 const LINE_ENDING_PATTERN = /\r\n|\n|\r/;
-const MAYBE_SPECIAL_PATTERN = /^[#$`~*+_=<>0-9|:-]/;
+const MAYBE_SPECIAL_PATTERN = /^[#$`~*+_=<>[0-9|:-]/;
 const ATX_MARKER_PATTERN = /^#{1,6}(?:[ \t]+|$)/;
 const ATX_ONLY_CLOSING_SEQUENCE_PATTERN = /^[ \t]*#+[ \t]*$/;
 const ATX_TRAILING_CLOSING_SEQUENCE_PATTERN = /[ \t]+#+[ \t]*$/;
@@ -45,8 +46,10 @@ function headingLevelOf(hashes) {
 }
 var BlockParser = class {
 	references = /* @__PURE__ */ new Map();
+	footnotes = /* @__PURE__ */ new Set();
 	document = new BlockNode("document", 1);
 	tables;
+	footnotesEnabled;
 	sink;
 	maxNesting;
 	tip = this.document;
@@ -58,6 +61,7 @@ var BlockParser = class {
 	nestingDepth = 0;
 	constructor(options) {
 		this.tables = options.gfmTables ?? true;
+		this.footnotesEnabled = options.footnotes ?? true;
 		this.sink = options.sink ?? NOOP_MARKDOWN_DIAGNOSTIC_SINK;
 		this.maxNesting = options.maxNesting ?? 250;
 	}
@@ -128,6 +132,7 @@ var BlockParser = class {
 			case "list": return "matched";
 			case "blockquote": return this.continueBlockquote();
 			case "listItem": return this.continueListItem(node);
+			case "footnoteDefinition": return this.continueFootnoteDefinition(node);
 			case "codeBlock": return this.continueCodeBlock(node);
 			case "mathBlock": return this.continueMathBlock(node);
 			case "htmlBlock": return this.line.blank && HTML_BLOCK_BLANK_LINE_END_TYPES.includes(node.htmlBlockType) ? "not-matched" : "matched";
@@ -162,6 +167,18 @@ var BlockParser = class {
 		}
 		return "not-matched";
 	}
+	continueFootnoteDefinition(node) {
+		if (this.line.blank) {
+			if (node.children.length === 0) return "not-matched";
+			this.line.advanceToNextNonspace();
+			return "matched";
+		}
+		if (this.line.indent >= 4) {
+			this.line.advance(4);
+			return "matched";
+		}
+		return "not-matched";
+	}
 	continueCodeBlock(node) {
 		if (!node.fenced) {
 			if (this.line.indent >= 4) {
@@ -215,6 +232,7 @@ var BlockParser = class {
 			() => this.tryAtxHeadingStart(),
 			() => this.tryCodeFenceStart(),
 			() => this.tryMathBlockStart(),
+			() => this.tryFootnoteDefinitionStart(container),
 			() => this.tryHtmlBlockStart(container),
 			() => this.tryPromoteParagraph(container),
 			() => this.tryThematicBreakStart(),
@@ -272,6 +290,29 @@ var BlockParser = class {
 		this.line.advance(MATH_BLOCK_MARKER_LENGTH);
 		return "leaf";
 	}
+	tryFootnoteDefinitionStart(container) {
+		if (!this.footnotesEnabled || this.line.indented || !this.footnoteDefinitionMayOpenIn(container)) return "none";
+		const marker = matchFootnoteDefinitionMarker(this.line.restFromNextNonspace());
+		if (marker === void 0) return "none";
+		if (this.footnotes.has(marker.label)) this.sink({
+			code: MarkdownDiagnosticCodes.DUPLICATE_FOOTNOTE_DEFINITION,
+			severity: "warning",
+			message: `footnote "${marker.label}" was already defined earlier in the document; every reference resolves to the first definition, and both definitions are kept as written`,
+			line: this.lineNumber
+		});
+		this.footnotes.add(marker.label);
+		this.line.advanceToNextNonspace();
+		this.closeUnmatchedBlocks();
+		const node = this.addChild("footnoteDefinition");
+		node.footnoteLabel = marker.label;
+		this.line.advance(marker.markerLength);
+		return "container";
+	}
+	footnoteDefinitionMayOpenIn(container) {
+		let node = container;
+		while (node?.kind === "list") node = node.parent;
+		return node?.kind === "document";
+	}
 	tryHtmlBlockStart(container) {
 		if (this.line.indented || this.line.peekNextNonspace() !== "<") return "none";
 		const interruptsParagraph = container.kind === "paragraph" || !this.allClosed && !this.line.blank && this.tip.kind === "paragraph";
@@ -428,15 +469,15 @@ var BlockParser = class {
 		node.literal = breakIndex === -1 ? "" : node.content.slice(breakIndex + 1);
 	}
 };
-function toInlineChildren(content, references, options) {
-	return parseInlines(content.trim(), references, options);
+function toInlineChildren(content, context) {
+	return parseInlines(content.trim(), context.references, context.footnotes, context.options);
 }
-function toHeadingNode(node, references, options) {
+function toHeadingNode(node, context) {
 	return {
 		type: "heading",
 		level: node.level,
 		style: node.setext ? "setext" : "atx",
-		children: toInlineChildren(node.content, references, options)
+		children: toInlineChildren(node.content, context)
 	};
 }
 function extractTaskListMarker(itemChildren) {
@@ -447,19 +488,19 @@ function extractTaskListMarker(itemChildren) {
 	first.content = first.content.slice(match[0].length);
 	return match[1] !== " ";
 }
-function toListItemNode(item, references, options) {
-	const checked = options.gfmTaskLists ?? true ? extractTaskListMarker(item.children) : void 0;
+function toListItemNode(item, context) {
+	const checked = context.options.gfmTaskLists ?? true ? extractTaskListMarker(item.children) : void 0;
 	return checked === void 0 ? {
 		type: "listItem",
-		children: toAstBlocks(item.children, references, options)
+		children: toAstBlocks(item.children, context)
 	} : {
 		type: "listItem",
 		checked,
-		children: toAstBlocks(item.children, references, options)
+		children: toAstBlocks(item.children, context)
 	};
 }
-function toListNode(node, references, options) {
-	const children = node.children.map((item) => toListItemNode(item, references, options));
+function toListNode(node, context) {
+	const children = node.children.map((item) => toListItemNode(item, context));
 	const data = node.listData;
 	if (data?.type === "ordered") return {
 		type: "list",
@@ -477,20 +518,20 @@ function toListNode(node, references, options) {
 		children
 	};
 }
-function toTableRow(cells, header, references, options) {
+function toTableRow(cells, header, context) {
 	return {
 		type: "tableRow",
 		header,
 		children: cells.map((cell) => ({
 			type: "tableCell",
-			children: toInlineChildren(cell, references, options)
+			children: toInlineChildren(cell, context)
 		}))
 	};
 }
-function toTableNode(node, references, options) {
-	const sink = options.sink ?? NOOP_MARKDOWN_DIAGNOSTIC_SINK;
+function toTableNode(node, context) {
+	const sink = context.options.sink ?? NOOP_MARKDOWN_DIAGNOSTIC_SINK;
 	const columnCount = node.alignments.length;
-	const rows = [toTableRow(fitRowToColumns(splitTableRow(node.headerLine), columnCount), true, references, options)];
+	const rows = [toTableRow(fitRowToColumns(splitTableRow(node.headerLine), columnCount), true, context)];
 	for (const rowLine of node.content.split("\n")) {
 		if (rowLine.trim().length === 0) continue;
 		const cells = splitTableRow(rowLine);
@@ -500,7 +541,7 @@ function toTableNode(node, references, options) {
 			message: `table row has ${String(cells.length)} cell(s), but the header row declares ${String(columnCount)}; the row is padded with empty cells or truncated to fit`,
 			line: node.startLine
 		});
-		rows.push(toTableRow(fitRowToColumns(cells, columnCount), false, references, options));
+		rows.push(toTableRow(fitRowToColumns(cells, columnCount), false, context));
 	}
 	return {
 		type: "table",
@@ -508,18 +549,23 @@ function toTableNode(node, references, options) {
 		children: rows
 	};
 }
-function toAstBlock(node, references, options) {
+function toAstBlock(node, context) {
 	switch (node.kind) {
 		case "paragraph": return {
 			type: "paragraph",
-			children: toInlineChildren(node.content, references, options)
+			children: toInlineChildren(node.content, context)
 		};
-		case "heading": return toHeadingNode(node, references, options);
+		case "heading": return toHeadingNode(node, context);
 		case "blockquote": return {
 			type: "blockquote",
-			children: toAstBlocks(node.children, references, options)
+			children: toAstBlocks(node.children, context)
+		};
+		case "list": return toListNode(node, context);
+		case "footnoteDefinition": return {
+			type: "footnoteDefinition",
+			label: node.footnoteLabel,
+			children: toAstBlocks(node.children, context)
 		};
-		case "list": return toListNode(node, references, options);
 		case "codeBlock": return node.fenced ? {
 			type: "codeBlock",
 			fenced: true,
@@ -540,15 +586,15 @@ function toAstBlock(node, references, options) {
 			type: "mathBlock",
 			literal: node.literal
 		};
-		case "table": return toTableNode(node, references, options);
+		case "table": return toTableNode(node, context);
 		case "document":
 		case "listItem": return;
 	}
 }
-function toAstBlocks(nodes, references, options) {
+function toAstBlocks(nodes, context) {
 	const blocks = [];
 	for (const node of nodes) {
-		const converted = toAstBlock(node, references, options);
+		const converted = toAstBlock(node, context);
 		if (converted !== void 0) blocks.push(converted);
 	}
 	return blocks;
@@ -556,13 +602,18 @@ function toAstBlocks(nodes, references, options) {
 function parseMarkdown(source, options = {}) {
 	const parser = new BlockParser(options);
 	const root = parser.parse(source);
-	const references = parser.references;
+	const context = {
+		references: parser.references,
+		footnotes: parser.footnotes,
+		options
+	};
 	return {
 		document: {
 			type: "document",
-			children: toAstBlocks(root.children, references, options)
+			children: toAstBlocks(root.children, context)
 		},
-		references
+		references: context.references,
+		footnotes: context.footnotes
 	};
 }
 //#endregion

package/dist/block/definitions.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-B72W0P_E.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.cjs";
 import { t as LinkReferenceDefinition } from "../link-Dv4kxVjk.cjs";
 //#region src/block/definitions.d.ts
 declare function extractDefinitions(content: string, references: Map<string, LinkReferenceDefinition>, sink?: MarkdownDiagnosticSink, startLine?: number): string;

package/dist/block/definitions.d.ts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-B72W0P_E.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-BuO5-SW1.js";
 import { t as LinkReferenceDefinition } from "../link-Dv4kxVjk.js";
 //#region src/block/definitions.d.ts
 declare function extractDefinitions(content: string, references: Map<string, LinkReferenceDefinition>, sink?: MarkdownDiagnosticSink, startLine?: number): string;

package/dist/block/node.cjs

@@ -22,6 +22,7 @@ var BlockNode = class {
 	tight = true;
 	alignments = [];
 	headerLine = "";
+	footnoteLabel = "";
 	constructor(kind, startLine) {
 		this.kind = kind;
 		this.startLine = startLine;
@@ -52,6 +53,7 @@ var BlockNode = class {
 };
 function canContain(parent, child) {
 	switch (parent) {
+		case "footnoteDefinition": return child !== "listItem" && child !== "footnoteDefinition";
 		case "document":
 		case "blockquote":
 		case "listItem": return child !== "listItem";

package/dist/block/node.d.cts

@@ -1,7 +1,7 @@
-import { i as MarkdownBulletMarker, j as MarkdownTableAlignment, w as MarkdownOrderedListDelimiter } from "../ast-DbjiuYr8.cjs";
+import { E as MarkdownOrderedListDelimiter, N as MarkdownTableAlignment, i as MarkdownBulletMarker } from "../ast-8XCbjRQT.cjs";
 import { t as HtmlBlockType } from "../html-bkz2QTuq.cjs";
 //#region src/block/node.d.ts
-type BlockNodeKind = 'document' | 'paragraph' | 'heading' | 'blockquote' | 'list' | 'listItem' | 'codeBlock' | 'htmlBlock' | 'thematicBreak' | 'table' | 'mathBlock';
+type BlockNodeKind = 'document' | 'paragraph' | 'heading' | 'blockquote' | 'list' | 'listItem' | 'codeBlock' | 'htmlBlock' | 'thematicBreak' | 'table' | 'mathBlock' | 'footnoteDefinition';
 type BlockHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 interface ListMarkerData {
   readonly type: 'bullet' | 'ordered';
@@ -33,6 +33,7 @@ declare class BlockNode {
   tight: boolean;
   alignments: MarkdownTableAlignment[];
   headerLine: string;
+  footnoteLabel: string;
   constructor(kind: BlockNodeKind, startLine: number);
   get lastChild(): BlockNode | undefined;
   appendChild(child: BlockNode): void;

package/dist/block/node.d.ts

@@ -1,7 +1,7 @@
-import { i as MarkdownBulletMarker, j as MarkdownTableAlignment, w as MarkdownOrderedListDelimiter } from "../ast-DbjiuYr8.js";
+import { E as MarkdownOrderedListDelimiter, N as MarkdownTableAlignment, i as MarkdownBulletMarker } from "../ast-8XCbjRQT.js";
 import { t as HtmlBlockType } from "../html-bkz2QTuq.js";
 //#region src/block/node.d.ts
-type BlockNodeKind = 'document' | 'paragraph' | 'heading' | 'blockquote' | 'list' | 'listItem' | 'codeBlock' | 'htmlBlock' | 'thematicBreak' | 'table' | 'mathBlock';
+type BlockNodeKind = 'document' | 'paragraph' | 'heading' | 'blockquote' | 'list' | 'listItem' | 'codeBlock' | 'htmlBlock' | 'thematicBreak' | 'table' | 'mathBlock' | 'footnoteDefinition';
 type BlockHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 interface ListMarkerData {
   readonly type: 'bullet' | 'ordered';
@@ -33,6 +33,7 @@ declare class BlockNode {
   tight: boolean;
   alignments: MarkdownTableAlignment[];
   headerLine: string;
+  footnoteLabel: string;
   constructor(kind: BlockNodeKind, startLine: number);
   get lastChild(): BlockNode | undefined;
   appendChild(child: BlockNode): void;

package/dist/block/node.js

@@ -21,6 +21,7 @@ var BlockNode = class {
 	tight = true;
 	alignments = [];
 	headerLine = "";
+	footnoteLabel = "";
 	constructor(kind, startLine) {
 		this.kind = kind;
 		this.startLine = startLine;
@@ -51,6 +52,7 @@ var BlockNode = class {
 };
 function canContain(parent, child) {
 	switch (parent) {
+		case "footnoteDefinition": return child !== "listItem" && child !== "footnoteDefinition";
 		case "document":
 		case "blockquote":
 		case "listItem": return child !== "listItem";

package/dist/block/table.d.cts

@@ -1,4 +1,4 @@
-import { j as MarkdownTableAlignment } from "../ast-DbjiuYr8.cjs";
+import { N as MarkdownTableAlignment } from "../ast-8XCbjRQT.cjs";
 //#region src/block/table.d.ts
 declare function splitTableRow(line: string): string[];
 declare function parseTableDelimiterRow(line: string): MarkdownTableAlignment[] | undefined;

package/dist/block/table.d.ts

@@ -1,4 +1,4 @@
-import { j as MarkdownTableAlignment } from "../ast-DbjiuYr8.js";
+import { N as MarkdownTableAlignment } from "../ast-8XCbjRQT.js";
 //#region src/block/table.d.ts
 declare function splitTableRow(line: string): string[];
 declare function parseTableDelimiterRow(line: string): MarkdownTableAlignment[] | undefined;

package/dist/diagnostics/diagnostics.cjs

@@ -7,6 +7,7 @@ const MarkdownDiagnosticCodes = {
 	UNTERMINATED_HTML_BLOCK: "md/unterminated-html-block",
 	TABLE_CELL_COUNT_MISMATCH: "md/table-cell-count-mismatch",
 	DUPLICATE_LINK_REFERENCE: "md/duplicate-link-reference",
+	DUPLICATE_FOOTNOTE_DEFINITION: "md/duplicate-footnote-definition",
 	LIST_MARKER_TYPE_CONFLICT: "md/list-marker-type-conflict",
 	INVENTED_PAGE_GEOMETRY: "md/invented-page-geometry",
 	NESTED_EMPHASIS_FLATTENED: "md/nested-emphasis-flattened",
@@ -21,6 +22,9 @@ const MarkdownDiagnosticCodes = {
 	MATH_BLOCK_PRESERVED_AS_TEXT: "md/math-block-preserved-as-text",
 	MATH_INLINE_PRESERVED_AS_TEXT: "md/math-inline-preserved-as-text",
 	FRONT_MATTER_KEY_UNMAPPED: "md/front-matter-key-unmapped",
+	FOOTNOTE_REFERENCE_PRESERVED_AS_TEXT: "md/footnote-reference-preserved-as-text",
+	FOOTNOTE_BODY_HEADING_FLATTENED: "md/footnote-body-heading-flattened",
+	CONSTRUCT_UNREPRESENTED: "md/construct-unrepresented",
 	HEADING_LEVEL_CLAMPED: "md/heading-level-clamped",
 	ADJACENT_LINKS_MERGED: "md/adjacent-links-merged",
 	CODE_SPAN_AS_MONOSPACE_RUN: "md/code-span-as-monospace-run",
@@ -69,6 +73,16 @@ var MarkdownWriteError = class extends Error {
 		this.code = code;
 	}
 };
+var MarkdownUnbalancedConstructMarkersError = class extends MarkdownWriteError {
+	imbalanceKind;
+	blockIndex;
+	constructor(imbalanceKind, blockIndex) {
+		super("md/unbalanced-construct-markers", `${imbalanceKind === "unmatchedEnd" ? "a constructEnd marker closes no open construct" : "a constructStart marker is never closed"} at block index ${String(blockIndex)}; a block list's construct boundary markers must pair as balanced brackets`);
+		this.name = "MarkdownUnbalancedConstructMarkersError";
+		this.imbalanceKind = imbalanceKind;
+		this.blockIndex = blockIndex;
+	}
+};
 var MarkdownUnsupportedDocumentKindError = class extends MarkdownWriteError {
 	kind;
 	constructor(kind) {
@@ -83,6 +97,7 @@ exports.MarkdownInputTooLargeError = MarkdownInputTooLargeError;
 exports.MarkdownInvalidUtf8Error = MarkdownInvalidUtf8Error;
 exports.MarkdownNestingLimitExceededError = MarkdownNestingLimitExceededError;
 exports.MarkdownParseError = MarkdownParseError;
+exports.MarkdownUnbalancedConstructMarkersError = MarkdownUnbalancedConstructMarkersError;
 exports.MarkdownUnsupportedDocumentKindError = MarkdownUnsupportedDocumentKindError;
 exports.MarkdownWriteError = MarkdownWriteError;
 exports.NOOP_MARKDOWN_DIAGNOSTIC_SINK = NOOP_MARKDOWN_DIAGNOSTIC_SINK;

package/dist/diagnostics/diagnostics.d.cts

@@ -1,2 +1,2 @@
-import { a as MarkdownInputTooLargeError, c as MarkdownParseError, d as NOOP_MARKDOWN_DIAGNOSTIC_SINK, i as MarkdownDiagnosticSink, l as MarkdownUnsupportedDocumentKindError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownWriteError } from "../diagnostics-B72W0P_E.cjs";
-export { MarkdownDiagnostic, MarkdownDiagnosticCodes, MarkdownDiagnosticSeverity, MarkdownDiagnosticSink, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK };
+import { a as MarkdownInputTooLargeError, c as MarkdownParseError, d as MarkdownWriteError, f as NOOP_MARKDOWN_DIAGNOSTIC_SINK, i as MarkdownDiagnosticSink, l as MarkdownUnbalancedConstructMarkersError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownUnsupportedDocumentKindError } from "../diagnostics-BuO5-SW1.cjs";
+export { MarkdownDiagnostic, MarkdownDiagnosticCodes, MarkdownDiagnosticSeverity, MarkdownDiagnosticSink, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK };

package/dist/diagnostics/diagnostics.d.ts

@@ -1,2 +1,2 @@
-import { a as MarkdownInputTooLargeError, c as MarkdownParseError, d as NOOP_MARKDOWN_DIAGNOSTIC_SINK, i as MarkdownDiagnosticSink, l as MarkdownUnsupportedDocumentKindError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownWriteError } from "../diagnostics-B72W0P_E.js";
-export { MarkdownDiagnostic, MarkdownDiagnosticCodes, MarkdownDiagnosticSeverity, MarkdownDiagnosticSink, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK };
+import { a as MarkdownInputTooLargeError, c as MarkdownParseError, d as MarkdownWriteError, f as NOOP_MARKDOWN_DIAGNOSTIC_SINK, i as MarkdownDiagnosticSink, l as MarkdownUnbalancedConstructMarkersError, n as MarkdownDiagnosticCodes, o as MarkdownInvalidUtf8Error, r as MarkdownDiagnosticSeverity, s as MarkdownNestingLimitExceededError, t as MarkdownDiagnostic, u as MarkdownUnsupportedDocumentKindError } from "../diagnostics-BuO5-SW1.js";
+export { MarkdownDiagnostic, MarkdownDiagnosticCodes, MarkdownDiagnosticSeverity, MarkdownDiagnosticSink, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK };

package/dist/diagnostics/diagnostics.js

@@ -6,6 +6,7 @@ const MarkdownDiagnosticCodes = {
 	UNTERMINATED_HTML_BLOCK: "md/unterminated-html-block",
 	TABLE_CELL_COUNT_MISMATCH: "md/table-cell-count-mismatch",
 	DUPLICATE_LINK_REFERENCE: "md/duplicate-link-reference",
+	DUPLICATE_FOOTNOTE_DEFINITION: "md/duplicate-footnote-definition",
 	LIST_MARKER_TYPE_CONFLICT: "md/list-marker-type-conflict",
 	INVENTED_PAGE_GEOMETRY: "md/invented-page-geometry",
 	NESTED_EMPHASIS_FLATTENED: "md/nested-emphasis-flattened",
@@ -20,6 +21,9 @@ const MarkdownDiagnosticCodes = {
 	MATH_BLOCK_PRESERVED_AS_TEXT: "md/math-block-preserved-as-text",
 	MATH_INLINE_PRESERVED_AS_TEXT: "md/math-inline-preserved-as-text",
 	FRONT_MATTER_KEY_UNMAPPED: "md/front-matter-key-unmapped",
+	FOOTNOTE_REFERENCE_PRESERVED_AS_TEXT: "md/footnote-reference-preserved-as-text",
+	FOOTNOTE_BODY_HEADING_FLATTENED: "md/footnote-body-heading-flattened",
+	CONSTRUCT_UNREPRESENTED: "md/construct-unrepresented",
 	HEADING_LEVEL_CLAMPED: "md/heading-level-clamped",
 	ADJACENT_LINKS_MERGED: "md/adjacent-links-merged",
 	CODE_SPAN_AS_MONOSPACE_RUN: "md/code-span-as-monospace-run",
@@ -68,6 +72,16 @@ var MarkdownWriteError = class extends Error {
 		this.code = code;
 	}
 };
+var MarkdownUnbalancedConstructMarkersError = class extends MarkdownWriteError {
+	imbalanceKind;
+	blockIndex;
+	constructor(imbalanceKind, blockIndex) {
+		super("md/unbalanced-construct-markers", `${imbalanceKind === "unmatchedEnd" ? "a constructEnd marker closes no open construct" : "a constructStart marker is never closed"} at block index ${String(blockIndex)}; a block list's construct boundary markers must pair as balanced brackets`);
+		this.name = "MarkdownUnbalancedConstructMarkersError";
+		this.imbalanceKind = imbalanceKind;
+		this.blockIndex = blockIndex;
+	}
+};
 var MarkdownUnsupportedDocumentKindError = class extends MarkdownWriteError {
 	kind;
 	constructor(kind) {
@@ -77,4 +91,4 @@ var MarkdownUnsupportedDocumentKindError = class extends MarkdownWriteError {
 	}
 };
 //#endregion
-export { MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK };
+export { MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK };

package/dist/{diagnostics-B72W0P_E.d.cts → diagnostics-BuO5-SW1.d.cts}

@@ -14,6 +14,7 @@ declare const MarkdownDiagnosticCodes: {
   readonly UNTERMINATED_HTML_BLOCK: "md/unterminated-html-block";
   readonly TABLE_CELL_COUNT_MISMATCH: "md/table-cell-count-mismatch";
   readonly DUPLICATE_LINK_REFERENCE: "md/duplicate-link-reference";
+  readonly DUPLICATE_FOOTNOTE_DEFINITION: "md/duplicate-footnote-definition";
   readonly LIST_MARKER_TYPE_CONFLICT: "md/list-marker-type-conflict";
   readonly INVENTED_PAGE_GEOMETRY: "md/invented-page-geometry";
   readonly NESTED_EMPHASIS_FLATTENED: "md/nested-emphasis-flattened";
@@ -28,6 +29,9 @@ declare const MarkdownDiagnosticCodes: {
   readonly MATH_BLOCK_PRESERVED_AS_TEXT: "md/math-block-preserved-as-text";
   readonly MATH_INLINE_PRESERVED_AS_TEXT: "md/math-inline-preserved-as-text";
   readonly FRONT_MATTER_KEY_UNMAPPED: "md/front-matter-key-unmapped";
+  readonly FOOTNOTE_REFERENCE_PRESERVED_AS_TEXT: "md/footnote-reference-preserved-as-text";
+  readonly FOOTNOTE_BODY_HEADING_FLATTENED: "md/footnote-body-heading-flattened";
+  readonly CONSTRUCT_UNREPRESENTED: "md/construct-unrepresented";
   readonly HEADING_LEVEL_CLAMPED: "md/heading-level-clamped";
   readonly ADJACENT_LINKS_MERGED: "md/adjacent-links-merged";
   readonly CODE_SPAN_AS_MONOSPACE_RUN: "md/code-span-as-monospace-run";
@@ -56,9 +60,14 @@ declare class MarkdownWriteError extends Error {
   readonly code: string;
   constructor(code: string, message: string);
 }
+declare class MarkdownUnbalancedConstructMarkersError extends MarkdownWriteError {
+  readonly imbalanceKind: 'unmatchedEnd' | 'unclosedStart';
+  readonly blockIndex: number;
+  constructor(imbalanceKind: 'unmatchedEnd' | 'unclosedStart', blockIndex: number);
+}
 declare class MarkdownUnsupportedDocumentKindError extends MarkdownWriteError {
   readonly kind: string;
   constructor(kind: string);
 }
 //#endregion
-export { MarkdownInputTooLargeError as a, MarkdownParseError as c, NOOP_MARKDOWN_DIAGNOSTIC_SINK as d, MarkdownDiagnosticSink as i, MarkdownUnsupportedDocumentKindError as l, MarkdownDiagnosticCodes as n, MarkdownInvalidUtf8Error as o, MarkdownDiagnosticSeverity as r, MarkdownNestingLimitExceededError as s, MarkdownDiagnostic as t, MarkdownWriteError as u };
+export { MarkdownInputTooLargeError as a, MarkdownParseError as c, MarkdownWriteError as d, NOOP_MARKDOWN_DIAGNOSTIC_SINK as f, MarkdownDiagnosticSink as i, MarkdownUnbalancedConstructMarkersError as l, MarkdownDiagnosticCodes as n, MarkdownInvalidUtf8Error as o, MarkdownDiagnosticSeverity as r, MarkdownNestingLimitExceededError as s, MarkdownDiagnostic as t, MarkdownUnsupportedDocumentKindError as u };

package/dist/{diagnostics-B72W0P_E.d.ts → diagnostics-BuO5-SW1.d.ts}

@@ -14,6 +14,7 @@ declare const MarkdownDiagnosticCodes: {
   readonly UNTERMINATED_HTML_BLOCK: "md/unterminated-html-block";
   readonly TABLE_CELL_COUNT_MISMATCH: "md/table-cell-count-mismatch";
   readonly DUPLICATE_LINK_REFERENCE: "md/duplicate-link-reference";
+  readonly DUPLICATE_FOOTNOTE_DEFINITION: "md/duplicate-footnote-definition";
   readonly LIST_MARKER_TYPE_CONFLICT: "md/list-marker-type-conflict";
   readonly INVENTED_PAGE_GEOMETRY: "md/invented-page-geometry";
   readonly NESTED_EMPHASIS_FLATTENED: "md/nested-emphasis-flattened";
@@ -28,6 +29,9 @@ declare const MarkdownDiagnosticCodes: {
   readonly MATH_BLOCK_PRESERVED_AS_TEXT: "md/math-block-preserved-as-text";
   readonly MATH_INLINE_PRESERVED_AS_TEXT: "md/math-inline-preserved-as-text";
   readonly FRONT_MATTER_KEY_UNMAPPED: "md/front-matter-key-unmapped";
+  readonly FOOTNOTE_REFERENCE_PRESERVED_AS_TEXT: "md/footnote-reference-preserved-as-text";
+  readonly FOOTNOTE_BODY_HEADING_FLATTENED: "md/footnote-body-heading-flattened";
+  readonly CONSTRUCT_UNREPRESENTED: "md/construct-unrepresented";
   readonly HEADING_LEVEL_CLAMPED: "md/heading-level-clamped";
   readonly ADJACENT_LINKS_MERGED: "md/adjacent-links-merged";
   readonly CODE_SPAN_AS_MONOSPACE_RUN: "md/code-span-as-monospace-run";
@@ -56,9 +60,14 @@ declare class MarkdownWriteError extends Error {
   readonly code: string;
   constructor(code: string, message: string);
 }
+declare class MarkdownUnbalancedConstructMarkersError extends MarkdownWriteError {
+  readonly imbalanceKind: 'unmatchedEnd' | 'unclosedStart';
+  readonly blockIndex: number;
+  constructor(imbalanceKind: 'unmatchedEnd' | 'unclosedStart', blockIndex: number);
+}
 declare class MarkdownUnsupportedDocumentKindError extends MarkdownWriteError {
   readonly kind: string;
   constructor(kind: string);
 }
 //#endregion
-export { MarkdownInputTooLargeError as a, MarkdownParseError as c, NOOP_MARKDOWN_DIAGNOSTIC_SINK as d, MarkdownDiagnosticSink as i, MarkdownUnsupportedDocumentKindError as l, MarkdownDiagnosticCodes as n, MarkdownInvalidUtf8Error as o, MarkdownDiagnosticSeverity as r, MarkdownNestingLimitExceededError as s, MarkdownDiagnostic as t, MarkdownWriteError as u };
+export { MarkdownInputTooLargeError as a, MarkdownParseError as c, MarkdownWriteError as d, NOOP_MARKDOWN_DIAGNOSTIC_SINK as f, MarkdownDiagnosticSink as i, MarkdownUnbalancedConstructMarkersError as l, MarkdownDiagnosticCodes as n, MarkdownInvalidUtf8Error as o, MarkdownDiagnosticSeverity as r, MarkdownNestingLimitExceededError as s, MarkdownDiagnostic as t, MarkdownUnsupportedDocumentKindError as u };

package/dist/emit/emit.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_inline_footnote = require("../inline/footnote.cjs");
 require("../defaults/defaults.cjs");
 const require_diagnostics_diagnostics = require("../diagnostics/diagnostics.cjs");
 const require_shared_list_id = require("../shared/list-id.cjs");
@@ -193,29 +194,98 @@ function renderListRegion(items, context) {
 	}
 	return out;
 }
-function emitBlocks(blocks, context) {
-	const parts = [];
-	let index = 0;
+function isConstructItem(item) {
+	return "descriptor" in item;
+}
+function groupConstructItems(blocks, start) {
+	const items = [];
+	let index = start;
 	while (index < blocks.length) {
 		const block = blocks[index];
 		if (block === void 0) break;
-		if (block.kind === "paragraph" && block.list !== void 0) {
+		index += 1;
+		if (block.kind === "constructEnd") return {
+			items,
+			next: index
+		};
+		if (block.kind === "constructStart") {
+			const nested = groupConstructItems(blocks, index);
+			items.push({
+				descriptor: block.descriptor,
+				children: nested.items
+			});
+			index = nested.next;
+			continue;
+		}
+		items.push({ block });
+	}
+	return {
+		items,
+		next: index
+	};
+}
+const FOOTNOTE_CONTINUATION_INDENT = 4;
+function renderFootnoteDefinition(name, body) {
+	const marker = `[^${name}]:`;
+	if (body.length === 0) return marker;
+	const indent = " ".repeat(FOOTNOTE_CONTINUATION_INDENT);
+	const [firstLine = "", ...restLines] = body.split("\n");
+	return [`${marker} ${firstLine}`, ...restLines.map((line) => line.length === 0 ? line : `${indent}${line}`)].join("\n");
+}
+function renderConstruct(item, context) {
+	const body = renderItems(item.children, context);
+	const { descriptor } = item;
+	if (descriptor.kind === "anchor" && descriptor.anchorType === "footnote") {
+		if (require_inline_footnote.isValidFootnoteLabel(descriptor.name)) return renderFootnoteDefinition(descriptor.name, body);
+		context.sink({
+			code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
+			severity: "info",
+			message: `a footnote anchor's own name "${descriptor.name}" cannot be spelled as a "[^label]:" marker (whitespace or "]" would reparse as something else); its own extent still renders in place, but the construct itself is not represented`
+		});
+		return body;
+	}
+	const detail = descriptor.kind === "anchor" ? `${descriptor.kind} (${descriptor.anchorType})` : descriptor.kind;
+	context.sink({
+		code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
+		severity: "info",
+		message: `a "${detail}" construct has no markdown syntax; its own extent still renders in place, but the construct itself is not represented`
+	});
+	return body;
+}
+function renderItems(items, context) {
+	const parts = [];
+	let index = 0;
+	while (index < items.length) {
+		const item = items[index];
+		if (item === void 0) break;
+		if (isConstructItem(item)) {
+			const rendered = renderConstruct(item, context);
+			if (rendered.length > 0) parts.push(rendered);
+			index += 1;
+			continue;
+		}
+		if (item.block.kind === "paragraph" && item.block.list !== void 0) {
 			const region = [];
 			let end = index;
-			for (let candidate = blocks[end]; candidate?.kind === "paragraph" && candidate.list !== void 0; candidate = blocks[end]) {
-				region.push(candidate);
+			for (let candidate = items[end]; candidate !== void 0 && !isConstructItem(candidate) && candidate.block.kind === "paragraph" && candidate.block.list !== void 0; candidate = items[end]) {
+				region.push(candidate.block);
 				end += 1;
 			}
 			parts.push(renderListRegion(region, context));
 			index = end;
 			continue;
 		}
-		const rendered = renderTopLevelBlock(block, context);
+		const rendered = renderTopLevelBlock(item.block, context);
 		if (rendered.length > 0) parts.push(rendered);
 		index += 1;
 	}
 	return parts.join("\n\n");
 }
+function emitBlocks(blocks, context) {
+	const imbalance = (0, document_schema_js.findConstructMarkerImbalance)(blocks);
+	if (imbalance !== void 0) throw new require_diagnostics_diagnostics.MarkdownUnbalancedConstructMarkersError(imbalance.kind, imbalance.index);
+	return renderItems(groupConstructItems(blocks, 0).items, context);
+}
 function emitMarkdown(document, options = {}) {
 	if (document.kind !== "wordprocessing") throw new require_diagnostics_diagnostics.MarkdownUnsupportedDocumentKindError(document.kind);
 	const context = {