markdown-codec 3.0.0 → 3.1.0

package/dist/emit/emit.js

@@ -1,12 +1,13 @@
+import { isValidFootnoteLabel } from "../inline/footnote.js";
 import "../defaults/defaults.js";
-import { MarkdownDiagnosticCodes, MarkdownUnsupportedDocumentKindError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "../diagnostics/diagnostics.js";
+import { MarkdownDiagnosticCodes, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "../diagnostics/diagnostics.js";
 import { parseListNumId } 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, parseHeadingStyleId } from "../shared/style-constants.js";
 import { emitFrontMatter } from "./front-matter.js";
 import { emitRuns } from "./inline.js";
 import { emitImage } from "./image.js";
 import { emitTable } from "./table.js";
-import { clampHeadingLevel } from "document-schema.js";
+import { clampHeadingLevel, findConstructMarkerImbalance } from "document-schema.js";
 //#region src/emit/emit.ts
 const MAX_SETEXT_LEVEL = 2;
 const SETEXT_LEVEL_1_CHAR = "=";
@@ -192,29 +193,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 (isValidFootnoteLabel(descriptor.name)) return renderFootnoteDefinition(descriptor.name, body);
+		context.sink({
+			code: 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: 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 = findConstructMarkerImbalance(blocks);
+	if (imbalance !== void 0) throw new MarkdownUnbalancedConstructMarkersError(imbalance.kind, imbalance.index);
+	return renderItems(groupConstructItems(blocks, 0).items, context);
+}
 function emitMarkdown(document, options = {}) {
 	if (document.kind !== "wordprocessing") throw new MarkdownUnsupportedDocumentKindError(document.kind);
 	const context = {

package/dist/emit/inline.cjs

@@ -85,6 +85,7 @@ function renderLeaf(run, context) {
 		});
 		return renderCodeSpan(run.text);
 	}
+	if (run.fontFamily === "Footnote Reference") return run.text;
 	if (run.fontFamily === "Cambria Math") return `\\(${run.text}\\)`;
 	return escapeMarkdownText(run.text);
 }
@@ -135,7 +136,7 @@ function renderNestedStyles(runs, depth, context) {
 	return out;
 }
 function isPlainAutolink(run) {
-	if (run.hyperlink === void 0 || run.hyperlink.length === 0 || run.bold === true || run.italic === true || run.strike === true || run.fontFamily === "Courier New" || run.fontFamily === "Cambria Math") return false;
+	if (run.hyperlink === void 0 || run.hyperlink.length === 0 || run.bold === true || run.italic === true || run.strike === true || run.fontFamily === "Courier New" || run.fontFamily === "Cambria Math" || run.fontFamily === "Footnote Reference") return false;
 	return run.text === run.hyperlink || run.hyperlink === `mailto:${run.text}`;
 }
 function escapeLinkDestination(destination) {

package/dist/emit/inline.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 { ContentRun } from "document-schema.js";
 //#region src/emit/inline.d.ts
 interface InlineEmitContext {

package/dist/emit/inline.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 { ContentRun } from "document-schema.js";
 //#region src/emit/inline.d.ts
 interface InlineEmitContext {

package/dist/emit/inline.js

@@ -84,6 +84,7 @@ function renderLeaf(run, context) {
 		});
 		return renderCodeSpan(run.text);
 	}
+	if (run.fontFamily === "Footnote Reference") return run.text;
 	if (run.fontFamily === "Cambria Math") return `\\(${run.text}\\)`;
 	return escapeMarkdownText(run.text);
 }
@@ -134,7 +135,7 @@ function renderNestedStyles(runs, depth, context) {
 	return out;
 }
 function isPlainAutolink(run) {
-	if (run.hyperlink === void 0 || run.hyperlink.length === 0 || run.bold === true || run.italic === true || run.strike === true || run.fontFamily === "Courier New" || run.fontFamily === "Cambria Math") return false;
+	if (run.hyperlink === void 0 || run.hyperlink.length === 0 || run.bold === true || run.italic === true || run.strike === true || run.fontFamily === "Courier New" || run.fontFamily === "Cambria Math" || run.fontFamily === "Footnote Reference") return false;
 	return run.text === run.hyperlink || run.hyperlink === `mailto:${run.text}`;
 }
 function escapeLinkDestination(destination) {

package/dist/emit/table.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 { InlineEmitContext } from "./inline.cjs";
 import { ContentTable } from "document-schema.js";
 //#region src/emit/table.d.ts

package/dist/emit/table.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 { InlineEmitContext } from "./inline.js";
 import { ContentTable } from "document-schema.js";
 //#region src/emit/table.d.ts

package/dist/footnote-CKk4JbLk.d.cts

@@ -0,0 +1,15 @@
+//#region src/inline/footnote.d.ts
+interface FootnoteLabelMatch {
+  readonly label: string;
+  readonly end: number;
+}
+declare function matchFootnoteLabel(text: string, start: number): FootnoteLabelMatch | undefined;
+interface FootnoteDefinitionMatch {
+  readonly label: string;
+  readonly markerLength: number;
+}
+declare function matchFootnoteDefinitionMarker(lineText: string): FootnoteDefinitionMatch | undefined;
+type FootnoteLabelSet = ReadonlySet<string>;
+declare function isValidFootnoteLabel(label: string): boolean;
+//#endregion
+export { matchFootnoteDefinitionMarker as a, isValidFootnoteLabel as i, FootnoteLabelMatch as n, matchFootnoteLabel as o, FootnoteLabelSet as r, FootnoteDefinitionMatch as t };

package/dist/footnote-CKk4JbLk.d.ts

@@ -0,0 +1,15 @@
+//#region src/inline/footnote.d.ts
+interface FootnoteLabelMatch {
+  readonly label: string;
+  readonly end: number;
+}
+declare function matchFootnoteLabel(text: string, start: number): FootnoteLabelMatch | undefined;
+interface FootnoteDefinitionMatch {
+  readonly label: string;
+  readonly markerLength: number;
+}
+declare function matchFootnoteDefinitionMarker(lineText: string): FootnoteDefinitionMatch | undefined;
+type FootnoteLabelSet = ReadonlySet<string>;
+declare function isValidFootnoteLabel(label: string): boolean;
+//#endregion
+export { matchFootnoteDefinitionMarker as a, isValidFootnoteLabel as i, FootnoteLabelMatch as n, matchFootnoteLabel as o, FootnoteLabelSet as r, FootnoteDefinitionMatch as t };

package/dist/html/render.cjs

@@ -79,6 +79,7 @@ function renderInline(node) {
 		case "rawHtml": return node.literal;
 		case "hardBreak": return "<br />\n";
 		case "softBreak": return "\n";
+		case "footnoteReference": return escapeHtml(`[^${node.label}]`);
 		case "mathInline": return `\\(${escapeHtml(node.literal)}\\)`;
 	}
 }
@@ -140,6 +141,12 @@ var HtmlRenderer = class {
 				this.out += `$$\n${escapeHtml(node.literal)}\n$$\n`;
 				this.cr();
 				return;
+			case "footnoteDefinition":
+				this.cr();
+				this.out += `${escapeHtml(`[^${node.label}]:`)}\n`;
+				this.render(node.children, false);
+				this.cr();
+				return;
 			case "document":
 			case "listItem":
 			case "tableRow":

package/dist/html/render.d.cts

@@ -1,4 +1,4 @@
-import { g as MarkdownInlineNode, s as MarkdownDocumentNode } from "../ast-DbjiuYr8.cjs";
+import { s as MarkdownDocumentNode, v as MarkdownInlineNode } from "../ast-8XCbjRQT.cjs";
 //#region src/html/render.d.ts
 declare function escapeHtml(text: string): string;
 declare function escapeHref(href: string): string;

package/dist/html/render.d.ts

@@ -1,4 +1,4 @@
-import { g as MarkdownInlineNode, s as MarkdownDocumentNode } from "../ast-DbjiuYr8.js";
+import { s as MarkdownDocumentNode, v as MarkdownInlineNode } from "../ast-8XCbjRQT.js";
 //#region src/html/render.d.ts
 declare function escapeHtml(text: string): string;
 declare function escapeHref(href: string): string;

package/dist/html/render.js

@@ -78,6 +78,7 @@ function renderInline(node) {
 		case "rawHtml": return node.literal;
 		case "hardBreak": return "<br />\n";
 		case "softBreak": return "\n";
+		case "footnoteReference": return escapeHtml(`[^${node.label}]`);
 		case "mathInline": return `\\(${escapeHtml(node.literal)}\\)`;
 	}
 }
@@ -139,6 +140,12 @@ var HtmlRenderer = class {
 				this.out += `$$\n${escapeHtml(node.literal)}\n$$\n`;
 				this.cr();
 				return;
+			case "footnoteDefinition":
+				this.cr();
+				this.out += `${escapeHtml(`[^${node.label}]:`)}\n`;
+				this.render(node.children, false);
+				this.cr();
+				return;
 			case "document":
 			case "listItem":
 			case "tableRow":

package/dist/index.cjs

@@ -6,6 +6,7 @@ const require_read = require("./read.cjs");
 const require_write = require("./write.cjs");
 const require_codec = require("./codec.cjs");
 exports.CODE_BLOCK_STYLE_ID = require_shared_style_constants.CODE_BLOCK_STYLE_ID;
+exports.FOOTNOTE_REFERENCE_FONT_MARKER = require_shared_style_constants.FOOTNOTE_REFERENCE_FONT_MARKER;
 exports.HORIZONTAL_RULE_STYLE_ID = require_shared_style_constants.HORIZONTAL_RULE_STYLE_ID;
 exports.HTML_PREFORMATTED_STYLE_ID = require_shared_style_constants.HTML_PREFORMATTED_STYLE_ID;
 exports.MAX_HEADING_STYLE_LEVEL = require_shared_style_constants.MAX_HEADING_STYLE_LEVEL;
@@ -16,6 +17,7 @@ exports.MarkdownInputTooLargeError = require_diagnostics_diagnostics.MarkdownInp
 exports.MarkdownInvalidUtf8Error = require_diagnostics_diagnostics.MarkdownInvalidUtf8Error;
 exports.MarkdownNestingLimitExceededError = require_diagnostics_diagnostics.MarkdownNestingLimitExceededError;
 exports.MarkdownParseError = require_diagnostics_diagnostics.MarkdownParseError;
+exports.MarkdownUnbalancedConstructMarkersError = require_diagnostics_diagnostics.MarkdownUnbalancedConstructMarkersError;
 exports.MarkdownUnsupportedDocumentKindError = require_diagnostics_diagnostics.MarkdownUnsupportedDocumentKindError;
 exports.MarkdownWriteError = require_diagnostics_diagnostics.MarkdownWriteError;
 exports.NOOP_MARKDOWN_DIAGNOSTIC_SINK = require_diagnostics_diagnostics.NOOP_MARKDOWN_DIAGNOSTIC_SINK;

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-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";
+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";
 import { MarkdownBytesSchema, markdownCodec } from "./codec.cjs";
 import { n as MarkdownImageResolver, r as MarkdownResolvedImageBytes, t as MarkdownImageResolveContext } from "./image-C4KYmz_L.cjs";
 import { MarkdownBulletListMarker, MarkdownCodeFenceChar, MarkdownEmphasisMarker, MarkdownHeadingStyle, MarkdownLineEnding, MarkdownOrderedListDelimiter, MarkdownThematicBreakChar, ReadMarkdownOptions, WriteMarkdownOptions, WriteMarkdownStyleOptions } from "./options/options.cjs";
 import { ReadMarkdownResult, readMarkdown } from "./read.cjs";
 import { writeMarkdown } from "./write.cjs";
 import { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.cjs";
-import { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.cjs";
-export { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, writeMarkdown };
+import { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.cjs";
+export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, writeMarkdown };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-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";
+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";
 import { MarkdownBytesSchema, markdownCodec } from "./codec.js";
 import { n as MarkdownImageResolver, r as MarkdownResolvedImageBytes, t as MarkdownImageResolveContext } from "./image-Cm3hT5PS.js";
 import { MarkdownBulletListMarker, MarkdownCodeFenceChar, MarkdownEmphasisMarker, MarkdownHeadingStyle, MarkdownLineEnding, MarkdownOrderedListDelimiter, MarkdownThematicBreakChar, ReadMarkdownOptions, WriteMarkdownOptions, WriteMarkdownStyleOptions } from "./options/options.js";
 import { ReadMarkdownResult, readMarkdown } from "./read.js";
 import { writeMarkdown } from "./write.js";
 import { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.js";
-import { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.js";
-export { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, writeMarkdown };
+import { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.js";
+export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, type ListNumIdInfo, type ListNumIdMintOptions, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, type MarkdownBulletListMarker, MarkdownBytesSchema, type MarkdownCodeFenceChar, type MarkdownDiagnostic, MarkdownDiagnosticCodes, type MarkdownDiagnosticSeverity, type MarkdownDiagnosticSink, type MarkdownEmphasisMarker, type MarkdownHeadingStyle, type MarkdownImageResolveContext, type MarkdownImageResolver, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, type MarkdownLineEnding, MarkdownNestingLimitExceededError, type MarkdownOrderedListDelimiter, MarkdownParseError, type MarkdownResolvedImageBytes, type MarkdownThematicBreakChar, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, type NumIdMintState, QUOTE_INDENT_PT, QUOTE_STYLE_ID, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, writeMarkdown };

package/dist/index.js

@@ -1,7 +1,7 @@
-import { MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "./diagnostics/diagnostics.js";
+import { MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK } from "./diagnostics/diagnostics.js";
 import { createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.js";
-import { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.js";
+import { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, headingStyleId, parseHeadingStyleId } from "./shared/style-constants.js";
 import { readMarkdown } from "./read.js";
 import { writeMarkdown } from "./write.js";
 import { MarkdownBytesSchema, markdownCodec } from "./codec.js";
-export { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, MarkdownBytesSchema, MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, QUOTE_INDENT_PT, QUOTE_STYLE_ID, createNumIdMintState, headingStyleId, markdownCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, writeMarkdown };
+export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, MarkdownBytesSchema, MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, QUOTE_INDENT_PT, QUOTE_STYLE_ID, createNumIdMintState, headingStyleId, markdownCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, writeMarkdown };

package/dist/inline/footnote.cjs

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/inline/footnote.ts
+const FOOTNOTE_LABEL_PATTERN = /\[\^([^\s[\]]+)\]/y;
+const FOOTNOTE_LABEL_ONLY_PATTERN = /^[^\s[\]]+$/;
+function matchFootnoteLabel(text, start) {
+	FOOTNOTE_LABEL_PATTERN.lastIndex = start;
+	const match = FOOTNOTE_LABEL_PATTERN.exec(text);
+	if (match === null) return;
+	const label = match[1];
+	if (label === void 0) return;
+	return {
+		label,
+		end: start + match[0].length
+	};
+}
+function matchFootnoteDefinitionMarker(lineText) {
+	const match = matchFootnoteLabel(lineText, 0);
+	if (match === void 0 || lineText.charAt(match.end) !== ":") return;
+	return {
+		label: match.label,
+		markerLength: match.end + 1
+	};
+}
+function isValidFootnoteLabel(label) {
+	return FOOTNOTE_LABEL_ONLY_PATTERN.test(label);
+}
+//#endregion
+exports.isValidFootnoteLabel = isValidFootnoteLabel;
+exports.matchFootnoteDefinitionMarker = matchFootnoteDefinitionMarker;
+exports.matchFootnoteLabel = matchFootnoteLabel;

package/dist/inline/footnote.d.cts

@@ -0,0 +1,2 @@
+import { a as matchFootnoteDefinitionMarker, i as isValidFootnoteLabel, n as FootnoteLabelMatch, o as matchFootnoteLabel, r as FootnoteLabelSet, t as FootnoteDefinitionMatch } from "../footnote-CKk4JbLk.cjs";
+export { FootnoteDefinitionMatch, FootnoteLabelMatch, FootnoteLabelSet, isValidFootnoteLabel, matchFootnoteDefinitionMarker, matchFootnoteLabel };

package/dist/inline/footnote.d.ts

@@ -0,0 +1,2 @@
+import { a as matchFootnoteDefinitionMarker, i as isValidFootnoteLabel, n as FootnoteLabelMatch, o as matchFootnoteLabel, r as FootnoteLabelSet, t as FootnoteDefinitionMatch } from "../footnote-CKk4JbLk.js";
+export { FootnoteDefinitionMatch, FootnoteLabelMatch, FootnoteLabelSet, isValidFootnoteLabel, matchFootnoteDefinitionMarker, matchFootnoteLabel };

package/dist/inline/footnote.js

@@ -0,0 +1,27 @@
+//#region src/inline/footnote.ts
+const FOOTNOTE_LABEL_PATTERN = /\[\^([^\s[\]]+)\]/y;
+const FOOTNOTE_LABEL_ONLY_PATTERN = /^[^\s[\]]+$/;
+function matchFootnoteLabel(text, start) {
+	FOOTNOTE_LABEL_PATTERN.lastIndex = start;
+	const match = FOOTNOTE_LABEL_PATTERN.exec(text);
+	if (match === null) return;
+	const label = match[1];
+	if (label === void 0) return;
+	return {
+		label,
+		end: start + match[0].length
+	};
+}
+function matchFootnoteDefinitionMarker(lineText) {
+	const match = matchFootnoteLabel(lineText, 0);
+	if (match === void 0 || lineText.charAt(match.end) !== ":") return;
+	return {
+		label: match.label,
+		markerLength: match.end + 1
+	};
+}
+function isValidFootnoteLabel(label) {
+	return FOOTNOTE_LABEL_ONLY_PATTERN.test(label);
+}
+//#endregion
+export { isValidFootnoteLabel, matchFootnoteDefinitionMarker, matchFootnoteLabel };

package/dist/inline/inline.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_inline_footnote = require("./footnote.cjs");
 const require_html_html = require("../html/html.cjs");
 const require_inline_chars = require("./chars.cjs");
 const require_inline_entity = require("./entity.cjs");
@@ -25,14 +26,16 @@ function createWrapper(kind, marker) {
 var InlineParser = class {
 	text;
 	references;
+	footnotes;
 	gfmStrikethrough;
 	container = new require_inline_node.InlineNode("container");
 	delimiters = new require_inline_delimiter.DelimiterStack();
 	brackets;
 	pos = 0;
-	constructor(text, references, options) {
+	constructor(text, references, footnotes, options) {
 		this.text = text;
 		this.references = references;
+		this.footnotes = footnotes;
 		this.gfmStrikethrough = options.gfmStrikethrough ?? true;
 	}
 	parse() {
@@ -238,9 +241,22 @@ var InlineParser = class {
 	}
 	parseOpenBracket() {
 		const start = this.pos;
+		const footnote = this.matchFootnoteReference();
+		if (footnote !== void 0) {
+			const node = new require_inline_node.InlineNode("footnoteReference");
+			node.label = footnote.label;
+			this.container.appendChild(node);
+			this.pos = footnote.end;
+			return;
+		}
 		this.pos += 1;
 		this.pushBracket(this.appendText("["), start, false);
 	}
+	matchFootnoteReference() {
+		const match = require_inline_footnote.matchFootnoteLabel(this.text, this.pos);
+		if (match === void 0 || !this.footnotes.has(match.label)) return;
+		return match;
+	}
 	parseBang() {
 		const start = this.pos;
 		this.pos += 1;
@@ -248,6 +264,10 @@ var InlineParser = class {
 			this.appendText("!");
 			return;
 		}
+		if (this.matchFootnoteReference() !== void 0) {
+			this.appendText("!");
+			return;
+		}
 		this.pos += 1;
 		this.pushBracket(this.appendText("!["), start + 1, true);
 	}
@@ -363,6 +383,7 @@ function flattenToPlainText(node) {
 		case "autolink": return node.destination;
 		case "softBreak":
 		case "hardBreak": return " ";
+		case "footnoteReference": return `[^${node.label}]`;
 		default: {
 			let result = "";
 			let child = node.firstChild;
@@ -458,11 +479,15 @@ function toAstNode(node) {
 			type: "mathInline",
 			literal: node.literal
 		};
+		case "footnoteReference": return {
+			type: "footnoteReference",
+			label: node.label
+		};
 		case "container": return;
 	}
 }
-function parseInlines(content, references, options = {}) {
-	const root = new InlineParser(content, references, options).parse();
+function parseInlines(content, references, footnotes, options = {}) {
+	const root = new InlineParser(content, references, footnotes, options).parse();
 	if (options.gfmAutolinks ?? true) {
 		require_inline_gfm_autolink.applyGfmAutolinks(root);
 		mergeAdjacentText(root);

package/dist/inline/inline.d.cts

@@ -1,2 +1,2 @@
-import { n as parseInlines, t as InlineParseOptions } from "../inline-uVHJ5xzT.cjs";
+import { n as parseInlines, t as InlineParseOptions } from "../inline-CXVQWQnW.cjs";
 export { InlineParseOptions, parseInlines };

package/dist/inline/inline.d.ts

@@ -1,2 +1,2 @@
-import { n as parseInlines, t as InlineParseOptions } from "../inline-TuBQ2TUr.js";
+import { n as parseInlines, t as InlineParseOptions } from "../inline-B_V7bs5j.js";
 export { InlineParseOptions, parseInlines };

package/dist/inline/inline.js

@@ -1,3 +1,4 @@
+import { matchFootnoteLabel } from "./footnote.js";
 import { matchHtmlTag } from "../html/html.js";
 import { containsAsciiControlOrSpace, isAsciiPunctuation } from "./chars.js";
 import { matchEntity } from "./entity.js";
@@ -24,14 +25,16 @@ function createWrapper(kind, marker) {
 var InlineParser = class {
 	text;
 	references;
+	footnotes;
 	gfmStrikethrough;
 	container = new InlineNode("container");
 	delimiters = new DelimiterStack();
 	brackets;
 	pos = 0;
-	constructor(text, references, options) {
+	constructor(text, references, footnotes, options) {
 		this.text = text;
 		this.references = references;
+		this.footnotes = footnotes;
 		this.gfmStrikethrough = options.gfmStrikethrough ?? true;
 	}
 	parse() {
@@ -237,9 +240,22 @@ var InlineParser = class {
 	}
 	parseOpenBracket() {
 		const start = this.pos;
+		const footnote = this.matchFootnoteReference();
+		if (footnote !== void 0) {
+			const node = new InlineNode("footnoteReference");
+			node.label = footnote.label;
+			this.container.appendChild(node);
+			this.pos = footnote.end;
+			return;
+		}
 		this.pos += 1;
 		this.pushBracket(this.appendText("["), start, false);
 	}
+	matchFootnoteReference() {
+		const match = matchFootnoteLabel(this.text, this.pos);
+		if (match === void 0 || !this.footnotes.has(match.label)) return;
+		return match;
+	}
 	parseBang() {
 		const start = this.pos;
 		this.pos += 1;
@@ -247,6 +263,10 @@ var InlineParser = class {
 			this.appendText("!");
 			return;
 		}
+		if (this.matchFootnoteReference() !== void 0) {
+			this.appendText("!");
+			return;
+		}
 		this.pos += 1;
 		this.pushBracket(this.appendText("!["), start + 1, true);
 	}
@@ -362,6 +382,7 @@ function flattenToPlainText(node) {
 		case "autolink": return node.destination;
 		case "softBreak":
 		case "hardBreak": return " ";
+		case "footnoteReference": return `[^${node.label}]`;
 		default: {
 			let result = "";
 			let child = node.firstChild;
@@ -457,11 +478,15 @@ function toAstNode(node) {
 			type: "mathInline",
 			literal: node.literal
 		};
+		case "footnoteReference": return {
+			type: "footnoteReference",
+			label: node.label
+		};
 		case "container": return;
 	}
 }
-function parseInlines(content, references, options = {}) {
-	const root = new InlineParser(content, references, options).parse();
+function parseInlines(content, references, footnotes, options = {}) {
+	const root = new InlineParser(content, references, footnotes, options).parse();
 	if (options.gfmAutolinks ?? true) {
 		applyGfmAutolinks(root);
 		mergeAdjacentText(root);

package/dist/inline/node.cjs

@@ -8,6 +8,7 @@ var InlineNode = class {
 	email = false;
 	marker = "*";
 	raw = "";
+	label = "";
 	parent;
 	firstChild;
 	lastChild;

package/dist/inline/node.d.cts

@@ -1,5 +1,5 @@
 //#region src/inline/node.d.ts
-type InlineNodeKind = 'text' | 'emphasis' | 'strong' | 'strikethrough' | 'codeSpan' | 'link' | 'image' | 'autolink' | 'hardBreak' | 'softBreak' | 'rawHtml' | 'entity' | 'mathInline' | 'container';
+type InlineNodeKind = 'text' | 'emphasis' | 'strong' | 'strikethrough' | 'codeSpan' | 'link' | 'image' | 'autolink' | 'hardBreak' | 'softBreak' | 'rawHtml' | 'entity' | 'mathInline' | 'footnoteReference' | 'container';
 declare class InlineNode {
   readonly kind: InlineNodeKind;
   literal: string;
@@ -8,6 +8,7 @@ declare class InlineNode {
   email: boolean;
   marker: '_' | '*';
   raw: string;
+  label: string;
   parent: InlineNode | undefined;
   firstChild: InlineNode | undefined;
   lastChild: InlineNode | undefined;

package/dist/inline/node.d.ts

@@ -1,5 +1,5 @@
 //#region src/inline/node.d.ts
-type InlineNodeKind = 'text' | 'emphasis' | 'strong' | 'strikethrough' | 'codeSpan' | 'link' | 'image' | 'autolink' | 'hardBreak' | 'softBreak' | 'rawHtml' | 'entity' | 'mathInline' | 'container';
+type InlineNodeKind = 'text' | 'emphasis' | 'strong' | 'strikethrough' | 'codeSpan' | 'link' | 'image' | 'autolink' | 'hardBreak' | 'softBreak' | 'rawHtml' | 'entity' | 'mathInline' | 'footnoteReference' | 'container';
 declare class InlineNode {
   readonly kind: InlineNodeKind;
   literal: string;
@@ -8,6 +8,7 @@ declare class InlineNode {
   email: boolean;
   marker: '_' | '*';
   raw: string;
+  label: string;
   parent: InlineNode | undefined;
   firstChild: InlineNode | undefined;
   lastChild: InlineNode | undefined;

package/dist/inline/node.js

@@ -7,6 +7,7 @@ var InlineNode = class {
 	email = false;
 	marker = "*";
 	raw = "";
+	label = "";
 	parent;
 	firstChild;
 	lastChild;