markdown-codec 4.1.0 → 5.0.0

package/README.md

@@ -69,7 +69,7 @@ pnpm add markdown-codec
 npm install markdown-codec
 ```
 
-Published to [npmjs.org](https://www.npmjs.com/package/markdown-codec) via OIDC trusted publishing. `dist/` is committed rather than gitignored — a holdover from a pre-publish period when a git-tarball install needed a working build; now a known cleanup.
+Published to [npmjs.org](https://www.npmjs.com/package/markdown-codec) via OIDC trusted publishing. `dist/` is gitignored like every other package's build output: the published tarball carries the release build, and a workspace consumer gets `dist/` from turbo's `^_build` ordering, never from the repository.
 
 ## Usage
 
@@ -200,7 +200,6 @@ Every construct `src/lower`/`src/emit` cannot represent losslessly is a document
 - **`md/raw-html-preserved-as-text`** — see the raw-HTML entry above.
 - **`md/table-cell-formatting-dropped`** / **`md/table-cell-multi-paragraph-joined`** — GFM cells have no rich-formatting or multi-paragraph representation.
 - **`md/duplicate-footnote-definition`** — two definitions share a label; every reference resolves to the first, both are kept as written.
-- **`md/footnote-reference-preserved-as-text`** — a reference site is a marked run, not an `anchor` construct; see [Footnotes](#footnotes).
 - **`md/footnote-body-heading-flattened`** — a heading inside a definition body is carried as literal ATX text, since a construct extent may not open or close a heading scope.
 - **`md/construct-unrepresented`** — a construct kind markdown has no syntax for renders transparently: its extent still appears, the construct itself does not.
 - **`md/package-table-dropped`** — `writeMarkdown` only, ahead of flattening: a `DocumentPackage`'s own `definitions`/`layers`/`attachments`/`destinations`/`pages` table has no flat-`ContentDocument` home (`flattenPackage`'s own envelope carries forward only `metadata` and `symbolTable`); fires once per non-empty table present.
@@ -209,10 +208,10 @@ Every construct `src/lower`/`src/emit` cannot represent losslessly is a document
 
 GitHub's footnote extension (`[^label]` markers, `[^label]: body` definitions) is on by default, alongside the four GFM toggles — switch it off with `footnotes: false`. Neither CommonMark nor the GFM spec document defines footnotes, so both spellings are ordinary text with it off.
 
-The two halves of a footnote map onto **two different mechanisms**, and that split is structural rather than a choice:
+The two halves of a footnote map onto the **same `anchor` construct at two different scopes**, and that split is structural rather than a choice:
 
 - **A definition becomes an `anchor` construct.** Lowering emits document-schema.js's construct boundary markers — a `constructStart` carrying `{ kind: 'anchor', anchorType: 'footnote', name }`, the definition's own lowered body blocks, and a `constructEnd` — which is what `readMarkdownContent` returns in its block flow, and what `decompose` promotes to a construct group of its own in the `DocumentPackage` `readMarkdown` returns (the descriptor rides the group's `node`, the body blocks its `children`). The body rides the construct's extent rather than `AnchorDescriptor.definition`, which names a key in a package-level definitions table: `DocumentPackage` does carry that table as a root (unlike the flat `ContentDocument`), but a table entry there is a flat descriptor record, not a container for block content, so a body that is genuinely several paragraphs, a code block, or a list still has nowhere to live as a table value either way — the construct's own bracketed extent is the one shape in this schema built to hold real block content. A bodyless `[^1]:` lowers to the point anchor the same descriptor describes: a pair with nothing between it.
-- **A reference site stays a marked run.** A construct's extent is block-scoped by document-schema.js's own definition, and a reference sits between two runs inside a paragraph, so no block-level boundary marker can bracket it without splitting the paragraph in two. The schema names this gap itself and parks the inline-anchor case on a run-level extent mechanism it has not shipped. Until it does, the reference is a `ContentRun` keeping its own `[^label]` spelling and carrying `FOOTNOTE_REFERENCE_FONT_MARKER`, reported through `md/footnote-reference-preserved-as-text`.
+- **A reference site becomes a point run-level `anchor` extent.** A reference sits between two runs inside a paragraph, so no block-level boundary marker can bracket it without splitting the paragraph in two — but a run-level construct extent (`RunConstructExtent` on `ContentParagraph.constructs`, document-schema.js 4.5.0) names exactly that shape. Lowering emits an ordinary text run keeping the reference's own `[^label]` spelling (the materialised rendering, so a consumer that ignores constructs still shows `[^1]`) plus a point extent — `{ kind: 'anchor', anchorType: 'footnote', name }` at `startRun === endRun` naming that run, the same wiring ooxml.js's docx reader mints for a `w:footnoteReference` — carried through `decompose`/`flattenPackage` verbatim, exactly the way a table cell's own markers are. The writer spells `[^label]` back out from the covering extent rather than from anything about the run's text (which is what still distinguishes a genuine reference from a deliberately-escaped literal `\[^1\]`), gated by the same label grammar as the definition marker: a foreign name that grammar cannot spell degrades to the run's own escaped text plus `md/construct-unrepresented`.
 
 Definitions are recognised only at the document's own top level. Inside a block quote or a list item, the pair's extent would sit inside a scope the enclosing container had already opened, which the marker contract forbids a producer from emitting — so the text stays an ordinary paragraph there. A heading inside a definition body is flattened to literal ATX text for the same reason.
 

package/dist/block/block.d.cts

@@ -1,6 +1,6 @@
 import { s as MarkdownDocumentNode } from "../ast-8XCbjRQT.cjs";
 import { r as FootnoteLabelSet } from "../footnote-CKk4JbLk.cjs";
-import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.cjs";
 import { LinkReferenceMap } from "../inline/link.cjs";
 import { t as InlineParseOptions } from "../inline-CoS1JzxI.cjs";
 //#region src/block/block.d.ts

package/dist/block/block.d.ts

@@ -1,6 +1,6 @@
 import { s as MarkdownDocumentNode } from "../ast-8XCbjRQT.js";
 import { r as FootnoteLabelSet } from "../footnote-CKk4JbLk.js";
-import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.js";
 import { LinkReferenceMap } from "../inline/link.js";
 import { t as InlineParseOptions } from "../inline-OGXVE6hB.js";
 //#region src/block/block.d.ts

package/dist/block/definitions.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.cjs";
 import { LinkReferenceDefinition } from "../inline/link.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-CUMLtGHJ.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.js";
 import { LinkReferenceDefinition } from "../inline/link.js";
 //#region src/block/definitions.d.ts
 declare function extractDefinitions(content: string, references: Map<string, LinkReferenceDefinition>, sink?: MarkdownDiagnosticSink, startLine?: number): string;

package/dist/diagnostics/diagnostics.cjs

@@ -19,7 +19,6 @@ const MarkdownDiagnosticCodes = {
 	RAW_HTML_DROPPED: "md/raw-html-dropped",
 	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",
 	PACKAGE_TABLE_DROPPED: "md/package-table-dropped",

package/dist/diagnostics/diagnostics.d.cts

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

package/dist/diagnostics/diagnostics.d.ts

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

package/dist/diagnostics/diagnostics.js

@@ -18,7 +18,6 @@ const MarkdownDiagnosticCodes = {
 	RAW_HTML_DROPPED: "md/raw-html-dropped",
 	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",
 	PACKAGE_TABLE_DROPPED: "md/package-table-dropped",

package/dist/{diagnostics-CUMLtGHJ.d.cts → diagnostics-CkcSYZf1.d.cts}

@@ -26,7 +26,6 @@ declare const MarkdownDiagnosticCodes: {
   readonly RAW_HTML_DROPPED: "md/raw-html-dropped";
   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 PACKAGE_TABLE_DROPPED: "md/package-table-dropped";

package/dist/{diagnostics-CUMLtGHJ.d.ts → diagnostics-CkcSYZf1.d.ts}

@@ -26,7 +26,6 @@ declare const MarkdownDiagnosticCodes: {
   readonly RAW_HTML_DROPPED: "md/raw-html-dropped";
   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 PACKAGE_TABLE_DROPPED: "md/package-table-dropped";

package/dist/emit/inline.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_inline_footnote = require("../inline/footnote.cjs");
 const require_diagnostics_diagnostics = require("../diagnostics/diagnostics.cjs");
 require("../shared/style-constants.cjs");
 //#region src/emit/inline.ts
@@ -67,7 +68,10 @@ function renderCodeSpan(text) {
 	const wouldBeStrippedOnReparse = !isAllSpaces && text.startsWith(" ") && text.endsWith(" ");
 	return risksFenceCollision || wouldBeStrippedOnReparse ? `${fence} ${text} ${fence}` : `${fence}${text}${fence}`;
 }
-function renderLeaf(run, context) {
+function footnoteReferenceAt(constructs, index) {
+	for (const extent of constructs ?? []) if (extent.descriptor.kind === "anchor" && extent.descriptor.anchorType === "footnote" && extent.startRun === index && extent.endRun === index) return extent.descriptor;
+}
+function renderLeaf(run, context, index, constructs) {
 	if (run.source?.format === "markdown") return run.source.xml;
 	if (run.fontFamily === "Courier New") {
 		context.sink({
@@ -77,7 +81,13 @@ function renderLeaf(run, context) {
 		});
 		return renderCodeSpan(run.text);
 	}
-	if (run.fontFamily === "Footnote Reference") return run.text;
+	const footnote = footnoteReferenceAt(constructs, index);
+	if (footnote !== void 0 && require_inline_footnote.isValidFootnoteLabel(footnote.name)) return `[^${footnote.name}]`;
+	if (footnote !== void 0) context.sink({
+		code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
+		severity: "info",
+		message: `a footnote reference anchor's own name "${footnote.name}" cannot be spelled as a "[^label]" marker (whitespace or "]" would reparse as something else); the run's own text renders escaped in its place, but the reference itself is not represented`
+	});
 	if (run.fontFamily === "Cambria Math") return `\\(${run.text}\\)`;
 	return escapeMarkdownText(run.text);
 }
@@ -110,8 +120,8 @@ function wrapForStyle(body, key, context, precedingText) {
 	const delimiter = key === "bold" ? marker.repeat(2) : marker;
 	return `${delimiter}${body}${delimiter}`;
 }
-function renderNestedStyles(runs, depth, context) {
-	if (depth >= STYLE_KEYS.length) return runs.map((run) => renderLeaf(run, context)).join("");
+function renderNestedStyles(runs, depth, context, base, constructs) {
+	if (depth >= STYLE_KEYS.length) return runs.map((run, local) => renderLeaf(run, context, base + local, constructs)).join("");
 	const key = STYLE_KEYS[depth];
 	let out = "";
 	let index = 0;
@@ -121,14 +131,14 @@ function renderNestedStyles(runs, depth, context) {
 		const active = styleActive(current, key);
 		let end = index + 1;
 		while (end < runs.length && styleActive(runs[end], key) === active) end += 1;
-		const inner = renderNestedStyles(runs.slice(index, end), depth + 1, context);
+		const inner = renderNestedStyles(runs.slice(index, end), depth + 1, context, base + index, constructs);
 		out += active ? wrapForStyle(inner, key, context, out) : inner;
 		index = end;
 	}
 	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" || run.fontFamily === "Footnote Reference") return false;
+function isPlainAutolink(run, footnoteReference) {
+	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" || footnoteReference !== void 0) return false;
 	return run.text === run.hyperlink || run.hyperlink === `mailto:${run.text}`;
 }
 function escapeLinkDestination(destination) {
@@ -157,7 +167,7 @@ function emitRuns(runs, context, constructs = void 0) {
 		if (run.hyperlink === void 0) {
 			let end = index + 1;
 			while (end < runs.length && runs[end]?.hyperlink === void 0) end += 1;
-			out += renderNestedStyles(runs.slice(index, end), 0, context);
+			out += renderNestedStyles(runs.slice(index, end), 0, context, index, constructs);
 			index = end;
 			continue;
 		}
@@ -171,9 +181,9 @@ function emitRuns(runs, context, constructs = void 0) {
 			message: `${String(group.length)} adjacent runs share the hyperlink "${hyperlink}"; markdown has no way to place two link boundaries back to back, so they render as one link spanning their combined text`
 		});
 		const title = linkTitleCovering(constructs, index, groupEnd);
-		if (title === void 0 && group.length === 1 && isPlainAutolink(group[0])) out += `<${group[0].text}>`;
+		if (title === void 0 && group.length === 1 && isPlainAutolink(group[0], footnoteReferenceAt(constructs, index))) out += `<${group[0].text}>`;
 		else {
-			const linkText = renderNestedStyles(group, 0, context);
+			const linkText = renderNestedStyles(group, 0, context, index, constructs);
 			out += `[${linkText}](${escapeLinkDestination(hyperlink)}${title === void 0 ? "" : ` "${renderLinkTitle(title)}"`})`;
 		}
 		index = groupEnd;

package/dist/emit/inline.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.cjs";
 import { ContentRun, RunConstructExtent } 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-CUMLtGHJ.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.js";
 import { ContentRun, RunConstructExtent } from "document-schema.js";
 //#region src/emit/inline.d.ts
 interface InlineEmitContext {

package/dist/emit/inline.js

@@ -1,3 +1,4 @@
+import { isValidFootnoteLabel } from "../inline/footnote.js";
 import { MarkdownDiagnosticCodes } from "../diagnostics/diagnostics.js";
 import "../shared/style-constants.js";
 //#region src/emit/inline.ts
@@ -66,7 +67,10 @@ function renderCodeSpan(text) {
 	const wouldBeStrippedOnReparse = !isAllSpaces && text.startsWith(" ") && text.endsWith(" ");
 	return risksFenceCollision || wouldBeStrippedOnReparse ? `${fence} ${text} ${fence}` : `${fence}${text}${fence}`;
 }
-function renderLeaf(run, context) {
+function footnoteReferenceAt(constructs, index) {
+	for (const extent of constructs ?? []) if (extent.descriptor.kind === "anchor" && extent.descriptor.anchorType === "footnote" && extent.startRun === index && extent.endRun === index) return extent.descriptor;
+}
+function renderLeaf(run, context, index, constructs) {
 	if (run.source?.format === "markdown") return run.source.xml;
 	if (run.fontFamily === "Courier New") {
 		context.sink({
@@ -76,7 +80,13 @@ function renderLeaf(run, context) {
 		});
 		return renderCodeSpan(run.text);
 	}
-	if (run.fontFamily === "Footnote Reference") return run.text;
+	const footnote = footnoteReferenceAt(constructs, index);
+	if (footnote !== void 0 && isValidFootnoteLabel(footnote.name)) return `[^${footnote.name}]`;
+	if (footnote !== void 0) context.sink({
+		code: MarkdownDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
+		severity: "info",
+		message: `a footnote reference anchor's own name "${footnote.name}" cannot be spelled as a "[^label]" marker (whitespace or "]" would reparse as something else); the run's own text renders escaped in its place, but the reference itself is not represented`
+	});
 	if (run.fontFamily === "Cambria Math") return `\\(${run.text}\\)`;
 	return escapeMarkdownText(run.text);
 }
@@ -109,8 +119,8 @@ function wrapForStyle(body, key, context, precedingText) {
 	const delimiter = key === "bold" ? marker.repeat(2) : marker;
 	return `${delimiter}${body}${delimiter}`;
 }
-function renderNestedStyles(runs, depth, context) {
-	if (depth >= STYLE_KEYS.length) return runs.map((run) => renderLeaf(run, context)).join("");
+function renderNestedStyles(runs, depth, context, base, constructs) {
+	if (depth >= STYLE_KEYS.length) return runs.map((run, local) => renderLeaf(run, context, base + local, constructs)).join("");
 	const key = STYLE_KEYS[depth];
 	let out = "";
 	let index = 0;
@@ -120,14 +130,14 @@ function renderNestedStyles(runs, depth, context) {
 		const active = styleActive(current, key);
 		let end = index + 1;
 		while (end < runs.length && styleActive(runs[end], key) === active) end += 1;
-		const inner = renderNestedStyles(runs.slice(index, end), depth + 1, context);
+		const inner = renderNestedStyles(runs.slice(index, end), depth + 1, context, base + index, constructs);
 		out += active ? wrapForStyle(inner, key, context, out) : inner;
 		index = end;
 	}
 	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" || run.fontFamily === "Footnote Reference") return false;
+function isPlainAutolink(run, footnoteReference) {
+	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" || footnoteReference !== void 0) return false;
 	return run.text === run.hyperlink || run.hyperlink === `mailto:${run.text}`;
 }
 function escapeLinkDestination(destination) {
@@ -156,7 +166,7 @@ function emitRuns(runs, context, constructs = void 0) {
 		if (run.hyperlink === void 0) {
 			let end = index + 1;
 			while (end < runs.length && runs[end]?.hyperlink === void 0) end += 1;
-			out += renderNestedStyles(runs.slice(index, end), 0, context);
+			out += renderNestedStyles(runs.slice(index, end), 0, context, index, constructs);
 			index = end;
 			continue;
 		}
@@ -170,9 +180,9 @@ function emitRuns(runs, context, constructs = void 0) {
 			message: `${String(group.length)} adjacent runs share the hyperlink "${hyperlink}"; markdown has no way to place two link boundaries back to back, so they render as one link spanning their combined text`
 		});
 		const title = linkTitleCovering(constructs, index, groupEnd);
-		if (title === void 0 && group.length === 1 && isPlainAutolink(group[0])) out += `<${group[0].text}>`;
+		if (title === void 0 && group.length === 1 && isPlainAutolink(group[0], footnoteReferenceAt(constructs, index))) out += `<${group[0].text}>`;
 		else {
-			const linkText = renderNestedStyles(group, 0, context);
+			const linkText = renderNestedStyles(group, 0, context, index, constructs);
 			out += `[${linkText}](${escapeLinkDestination(hyperlink)}${title === void 0 ? "" : ` "${renderLinkTitle(title)}"`})`;
 		}
 		index = groupEnd;

package/dist/emit/table.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.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-CUMLtGHJ.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.js";
 import { InlineEmitContext } from "./inline.js";
 import { ContentTable } from "document-schema.js";
 //#region src/emit/table.d.ts

package/dist/index.cjs

@@ -6,7 +6,6 @@ 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;

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { a as MarkdownInputTooLargeError, c as MarkdownNestingLimitExceededError, d as MarkdownUnbalancedConstructMarkersError, f as MarkdownUnsupportedDocumentKindError, i as MarkdownDiagnosticSink, m as NOOP_MARKDOWN_DIAGNOSTIC_SINK, n as MarkdownDiagnosticCodes, o as MarkdownInvalidRunConstructExtentError, p as MarkdownWriteError, r as MarkdownDiagnosticSeverity, s as MarkdownInvalidUtf8Error, t as MarkdownDiagnostic, u as MarkdownParseError } from "./diagnostics-CUMLtGHJ.cjs";
+import { a as MarkdownInputTooLargeError, c as MarkdownNestingLimitExceededError, d as MarkdownUnbalancedConstructMarkersError, f as MarkdownUnsupportedDocumentKindError, i as MarkdownDiagnosticSink, m as NOOP_MARKDOWN_DIAGNOSTIC_SINK, n as MarkdownDiagnosticCodes, o as MarkdownInvalidRunConstructExtentError, p as MarkdownWriteError, r as MarkdownDiagnosticSeverity, s as MarkdownInvalidUtf8Error, t as MarkdownDiagnostic, u as MarkdownParseError } from "./diagnostics-CkcSYZf1.cjs";
 import { MarkdownBytesSchema, markdownCodec, markdownContentCodec } 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 { ReadMarkdownContentResult, ReadMarkdownResult, readMarkdown, readMarkdownContent } from "./read.cjs";
 import { writeMarkdown, writeMarkdownContent } from "./write.cjs";
 import { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.cjs";
-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, MarkdownInvalidRunConstructExtentError, 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 ReadMarkdownContentResult, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };
+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, MarkdownInvalidRunConstructExtentError, 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 ReadMarkdownContentResult, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { a as MarkdownInputTooLargeError, c as MarkdownNestingLimitExceededError, d as MarkdownUnbalancedConstructMarkersError, f as MarkdownUnsupportedDocumentKindError, i as MarkdownDiagnosticSink, m as NOOP_MARKDOWN_DIAGNOSTIC_SINK, n as MarkdownDiagnosticCodes, o as MarkdownInvalidRunConstructExtentError, p as MarkdownWriteError, r as MarkdownDiagnosticSeverity, s as MarkdownInvalidUtf8Error, t as MarkdownDiagnostic, u as MarkdownParseError } from "./diagnostics-CUMLtGHJ.js";
+import { a as MarkdownInputTooLargeError, c as MarkdownNestingLimitExceededError, d as MarkdownUnbalancedConstructMarkersError, f as MarkdownUnsupportedDocumentKindError, i as MarkdownDiagnosticSink, m as NOOP_MARKDOWN_DIAGNOSTIC_SINK, n as MarkdownDiagnosticCodes, o as MarkdownInvalidRunConstructExtentError, p as MarkdownWriteError, r as MarkdownDiagnosticSeverity, s as MarkdownInvalidUtf8Error, t as MarkdownDiagnostic, u as MarkdownParseError } from "./diagnostics-CkcSYZf1.js";
 import { MarkdownBytesSchema, markdownCodec, markdownContentCodec } 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 { ReadMarkdownContentResult, ReadMarkdownResult, readMarkdown, readMarkdownContent } from "./read.js";
 import { writeMarkdown, writeMarkdownContent } from "./write.js";
 import { ListNumIdInfo, ListNumIdMintOptions, NumIdMintState, createNumIdMintState, mintListNumId, mintedListType, parseListNumId } from "./shared/list-id.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";
-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, MarkdownInvalidRunConstructExtentError, 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 ReadMarkdownContentResult, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };
+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, MarkdownInvalidRunConstructExtentError, 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 ReadMarkdownContentResult, type ReadMarkdownOptions, type ReadMarkdownResult, type WriteMarkdownOptions, type WriteMarkdownStyleOptions, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidRunConstructExtentError, 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, 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 { 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 { readMarkdown, readMarkdownContent } from "./read.js";
 import { writeMarkdown, writeMarkdownContent } from "./write.js";
 import { MarkdownBytesSchema, markdownCodec, markdownContentCodec } from "./codec.js";
-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, MarkdownInvalidRunConstructExtentError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, QUOTE_INDENT_PT, QUOTE_STYLE_ID, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };
+export { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, MarkdownBytesSchema, MarkdownDiagnosticCodes, MarkdownInputTooLargeError, MarkdownInvalidRunConstructExtentError, MarkdownInvalidUtf8Error, MarkdownNestingLimitExceededError, MarkdownParseError, MarkdownUnbalancedConstructMarkersError, MarkdownUnsupportedDocumentKindError, MarkdownWriteError, NOOP_MARKDOWN_DIAGNOSTIC_SINK, QUOTE_INDENT_PT, QUOTE_STYLE_ID, createNumIdMintState, headingStyleId, markdownCodec, markdownContentCodec, mintListNumId, mintedListType, parseHeadingStyleId, parseListNumId, readMarkdown, readMarkdownContent, writeMarkdown, writeMarkdownContent };

package/dist/lower/front-matter.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.cjs";
 import { LayoutMetadata } from "document-schema.js";
 //#region src/lower/front-matter.d.ts
 interface FrontMatterResult {

package/dist/lower/front-matter.d.ts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.js";
 import { LayoutMetadata } from "document-schema.js";
 //#region src/lower/front-matter.d.ts
 interface FrontMatterResult {

package/dist/lower/inline.cjs

@@ -72,12 +72,16 @@ function lowerInlineNodeInto(node, style, context, runs, extents) {
 			runs.push(buildRun(node.literal, style, require_shared_style_constants.MATH_INLINE_FONT_MARKER));
 			return;
 		case "footnoteReference":
-			context.sink({
-				code: require_diagnostics_diagnostics.MarkdownDiagnosticCodes.FOOTNOTE_REFERENCE_PRESERVED_AS_TEXT,
-				severity: "info",
-				message: `footnote reference "[^${node.label}]" is preserved as a marked text run rather than an anchor construct: a construct's extent is block-scoped, and a reference site sits between two runs inside a paragraph, which no block-level boundary marker can bracket`
+			runs.push(buildRun(`[^${node.label}]`, style));
+			extents.push({
+				descriptor: {
+					kind: "anchor",
+					anchorType: "footnote",
+					name: node.label
+				},
+				startRun: runs.length - 1,
+				endRun: runs.length - 1
 			});
-			runs.push(buildRun(`[^${node.label}]`, style, require_shared_style_constants.FOOTNOTE_REFERENCE_FONT_MARKER));
 			return;
 		case "autolink": {
 			const destination = node.email ? `mailto:${node.destination}` : node.destination;
@@ -140,7 +144,7 @@ function lowerInlineNodes(nodes, context) {
 	lowerNodesInto(nodes, {}, context, runs, extents);
 	return {
 		runs,
-		linkTitleExtents: extents
+		runConstructExtents: extents
 	};
 }
 function lowerCodeBlockRun(literal) {

package/dist/lower/inline.d.cts

@@ -1,5 +1,5 @@
 import { v as MarkdownInlineNode } from "../ast-8XCbjRQT.cjs";
-import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.cjs";
 import { ContentRun, RunConstructExtent } from "document-schema.js";
 //#region src/lower/inline.d.ts
 interface InlineLowerContext {
@@ -8,7 +8,7 @@ interface InlineLowerContext {
 }
 interface InlineLowerResult {
   readonly runs: ContentRun[];
-  readonly linkTitleExtents: readonly RunConstructExtent[];
+  readonly runConstructExtents: readonly RunConstructExtent[];
 }
 declare function lowerInlineNodes(nodes: readonly MarkdownInlineNode[], context: InlineLowerContext): InlineLowerResult;
 declare function lowerCodeBlockRun(literal: string): ContentRun;

package/dist/lower/inline.d.ts

@@ -1,5 +1,5 @@
 import { v as MarkdownInlineNode } from "../ast-8XCbjRQT.js";
-import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.js";
 import { ContentRun, RunConstructExtent } from "document-schema.js";
 //#region src/lower/inline.d.ts
 interface InlineLowerContext {
@@ -8,7 +8,7 @@ interface InlineLowerContext {
 }
 interface InlineLowerResult {
   readonly runs: ContentRun[];
-  readonly linkTitleExtents: readonly RunConstructExtent[];
+  readonly runConstructExtents: readonly RunConstructExtent[];
 }
 declare function lowerInlineNodes(nodes: readonly MarkdownInlineNode[], context: InlineLowerContext): InlineLowerResult;
 declare function lowerCodeBlockRun(literal: string): ContentRun;

package/dist/lower/inline.js

@@ -1,5 +1,5 @@
 import { MarkdownDiagnosticCodes } from "../diagnostics/diagnostics.js";
-import { FOOTNOTE_REFERENCE_FONT_MARKER, MATH_INLINE_FONT_MARKER, MONOSPACE_FONT_FAMILY } from "../shared/style-constants.js";
+import { MATH_INLINE_FONT_MARKER, MONOSPACE_FONT_FAMILY } from "../shared/style-constants.js";
 //#region src/lower/inline.ts
 function buildRun(text, style, fontFamily) {
 	return {
@@ -71,12 +71,16 @@ function lowerInlineNodeInto(node, style, context, runs, extents) {
 			runs.push(buildRun(node.literal, style, MATH_INLINE_FONT_MARKER));
 			return;
 		case "footnoteReference":
-			context.sink({
-				code: MarkdownDiagnosticCodes.FOOTNOTE_REFERENCE_PRESERVED_AS_TEXT,
-				severity: "info",
-				message: `footnote reference "[^${node.label}]" is preserved as a marked text run rather than an anchor construct: a construct's extent is block-scoped, and a reference site sits between two runs inside a paragraph, which no block-level boundary marker can bracket`
+			runs.push(buildRun(`[^${node.label}]`, style));
+			extents.push({
+				descriptor: {
+					kind: "anchor",
+					anchorType: "footnote",
+					name: node.label
+				},
+				startRun: runs.length - 1,
+				endRun: runs.length - 1
 			});
-			runs.push(buildRun(`[^${node.label}]`, style, FOOTNOTE_REFERENCE_FONT_MARKER));
 			return;
 		case "autolink": {
 			const destination = node.email ? `mailto:${node.destination}` : node.destination;
@@ -139,7 +143,7 @@ function lowerInlineNodes(nodes, context) {
 	lowerNodesInto(nodes, {}, context, runs, extents);
 	return {
 		runs,
-		linkTitleExtents: extents
+		runConstructExtents: extents
 	};
 }
 function lowerCodeBlockRun(literal) {

package/dist/lower/lower.cjs

@@ -29,17 +29,17 @@ function decorateParagraph(paragraph, context) {
 	};
 	return result;
 }
-function paragraphWithConstructs(runs, linkTitleExtents) {
+function paragraphWithConstructs(runs, runConstructExtents) {
 	return {
 		runs,
-		...linkTitleExtents.length > 0 ? { constructs: [...linkTitleExtents] } : {}
+		...runConstructExtents.length > 0 ? { constructs: [...runConstructExtents] } : {}
 	};
 }
 function lowerHeading(node, context) {
 	const inline = require_lower_inline.lowerInlineNodes(node.children, inlineContext(context));
 	return [decorateParagraph({
 		kind: "paragraph",
-		...paragraphWithConstructs(inline.runs, inline.linkTitleExtents),
+		...paragraphWithConstructs(inline.runs, inline.runConstructExtents),
 		styleId: require_shared_style_constants.headingStyleId(node.level),
 		headingLevel: node.level
 	}, context)];
@@ -53,7 +53,7 @@ function lowerParagraph(node, context) {
 		const inline = require_lower_inline.lowerInlineNodes(segment, inlineCtx);
 		blocks.push(decorateParagraph({
 			kind: "paragraph",
-			...paragraphWithConstructs(inline.runs, inline.linkTitleExtents)
+			...paragraphWithConstructs(inline.runs, inline.runConstructExtents)
 		}, context));
 		segment = [];
 	};

package/dist/lower/lower.js

@@ -28,17 +28,17 @@ function decorateParagraph(paragraph, context) {
 	};
 	return result;
 }
-function paragraphWithConstructs(runs, linkTitleExtents) {
+function paragraphWithConstructs(runs, runConstructExtents) {
 	return {
 		runs,
-		...linkTitleExtents.length > 0 ? { constructs: [...linkTitleExtents] } : {}
+		...runConstructExtents.length > 0 ? { constructs: [...runConstructExtents] } : {}
 	};
 }
 function lowerHeading(node, context) {
 	const inline = lowerInlineNodes(node.children, inlineContext(context));
 	return [decorateParagraph({
 		kind: "paragraph",
-		...paragraphWithConstructs(inline.runs, inline.linkTitleExtents),
+		...paragraphWithConstructs(inline.runs, inline.runConstructExtents),
 		styleId: headingStyleId(node.level),
 		headingLevel: node.level
 	}, context)];
@@ -52,7 +52,7 @@ function lowerParagraph(node, context) {
 		const inline = lowerInlineNodes(segment, inlineCtx);
 		blocks.push(decorateParagraph({
 			kind: "paragraph",
-			...paragraphWithConstructs(inline.runs, inline.linkTitleExtents)
+			...paragraphWithConstructs(inline.runs, inline.runConstructExtents)
 		}, context));
 		segment = [];
 	};

package/dist/lower/table.cjs

@@ -11,7 +11,7 @@ function lowerTableCell(cell, alignment, context) {
 	return { blocks: [{
 		kind: "paragraph",
 		runs: inline.runs,
-		...inline.linkTitleExtents.length > 0 ? { constructs: [...inline.linkTitleExtents] } : {},
+		...inline.runConstructExtents.length > 0 ? { constructs: [...inline.runConstructExtents] } : {},
 		...paragraphAlignment === void 0 ? {} : { alignment: paragraphAlignment }
 	}] };
 }

package/dist/lower/table.js

@@ -10,7 +10,7 @@ function lowerTableCell(cell, alignment, context) {
 	return { blocks: [{
 		kind: "paragraph",
 		runs: inline.runs,
-		...inline.linkTitleExtents.length > 0 ? { constructs: [...inline.linkTitleExtents] } : {},
+		...inline.runConstructExtents.length > 0 ? { constructs: [...inline.runConstructExtents] } : {},
 		...paragraphAlignment === void 0 ? {} : { alignment: paragraphAlignment }
 	}] };
 }

package/dist/options/options.d.cts

@@ -1,4 +1,4 @@
-import { i as MarkdownDiagnosticSink } from "../diagnostics-CUMLtGHJ.cjs";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.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-CUMLtGHJ.js";
+import { i as MarkdownDiagnosticSink } from "../diagnostics-CkcSYZf1.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.d.cts

@@ -1,4 +1,4 @@
-import { t as MarkdownDiagnostic } from "./diagnostics-CUMLtGHJ.cjs";
+import { t as MarkdownDiagnostic } from "./diagnostics-CkcSYZf1.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-CUMLtGHJ.js";
+import { t as MarkdownDiagnostic } from "./diagnostics-CkcSYZf1.js";
 import { ReadMarkdownOptions } from "./options/options.js";
 import { ContentDocument, DocumentPackage } from "document-schema.js";
 //#region src/read.d.ts

package/dist/shared/style-constants.cjs

@@ -19,13 +19,11 @@ const HTML_PREFORMATTED_STYLE_ID = "HTMLPreformatted";
 const MATH_BLOCK_STYLE_ID = "MathBlock";
 const MONOSPACE_FONT_FAMILY = "Courier New";
 const MATH_INLINE_FONT_MARKER = "Cambria Math";
-const FOOTNOTE_REFERENCE_FONT_MARKER = "Footnote Reference";
 const QUOTE_INDENT_PT = 36;
 const TASK_CHECKBOX_UNCHECKED = "☐";
 const TASK_CHECKBOX_CHECKED = "☒";
 //#endregion
 exports.CODE_BLOCK_STYLE_ID = CODE_BLOCK_STYLE_ID;
-exports.FOOTNOTE_REFERENCE_FONT_MARKER = FOOTNOTE_REFERENCE_FONT_MARKER;
 exports.HORIZONTAL_RULE_STYLE_ID = HORIZONTAL_RULE_STYLE_ID;
 exports.HTML_PREFORMATTED_STYLE_ID = HTML_PREFORMATTED_STYLE_ID;
 exports.MATH_BLOCK_STYLE_ID = MATH_BLOCK_STYLE_ID;

package/dist/shared/style-constants.d.cts

@@ -9,9 +9,8 @@ declare const HTML_PREFORMATTED_STYLE_ID = "HTMLPreformatted";
 declare const MATH_BLOCK_STYLE_ID = "MathBlock";
 declare const MONOSPACE_FONT_FAMILY = "Courier New";
 declare const MATH_INLINE_FONT_MARKER = "Cambria Math";
-declare const FOOTNOTE_REFERENCE_FONT_MARKER = "Footnote Reference";
 declare const QUOTE_INDENT_PT = 36;
 declare const TASK_CHECKBOX_UNCHECKED = "☐";
 declare const TASK_CHECKBOX_CHECKED = "☒";
 //#endregion
-export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MATH_BLOCK_STYLE_ID, MATH_INLINE_FONT_MARKER, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, TASK_CHECKBOX_CHECKED, TASK_CHECKBOX_UNCHECKED, headingStyleId, parseHeadingStyleId };
+export { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MATH_BLOCK_STYLE_ID, MATH_INLINE_FONT_MARKER, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, TASK_CHECKBOX_CHECKED, TASK_CHECKBOX_UNCHECKED, headingStyleId, parseHeadingStyleId };

package/dist/shared/style-constants.d.ts

@@ -9,9 +9,8 @@ declare const HTML_PREFORMATTED_STYLE_ID = "HTMLPreformatted";
 declare const MATH_BLOCK_STYLE_ID = "MathBlock";
 declare const MONOSPACE_FONT_FAMILY = "Courier New";
 declare const MATH_INLINE_FONT_MARKER = "Cambria Math";
-declare const FOOTNOTE_REFERENCE_FONT_MARKER = "Footnote Reference";
 declare const QUOTE_INDENT_PT = 36;
 declare const TASK_CHECKBOX_UNCHECKED = "☐";
 declare const TASK_CHECKBOX_CHECKED = "☒";
 //#endregion
-export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MATH_BLOCK_STYLE_ID, MATH_INLINE_FONT_MARKER, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, TASK_CHECKBOX_CHECKED, TASK_CHECKBOX_UNCHECKED, headingStyleId, parseHeadingStyleId };
+export { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MATH_BLOCK_STYLE_ID, MATH_INLINE_FONT_MARKER, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, TASK_CHECKBOX_CHECKED, TASK_CHECKBOX_UNCHECKED, headingStyleId, parseHeadingStyleId };

package/dist/shared/style-constants.js

@@ -18,9 +18,8 @@ const HTML_PREFORMATTED_STYLE_ID = "HTMLPreformatted";
 const MATH_BLOCK_STYLE_ID = "MathBlock";
 const MONOSPACE_FONT_FAMILY = "Courier New";
 const MATH_INLINE_FONT_MARKER = "Cambria Math";
-const FOOTNOTE_REFERENCE_FONT_MARKER = "Footnote Reference";
 const QUOTE_INDENT_PT = 36;
 const TASK_CHECKBOX_UNCHECKED = "☐";
 const TASK_CHECKBOX_CHECKED = "☒";
 //#endregion
-export { CODE_BLOCK_STYLE_ID, FOOTNOTE_REFERENCE_FONT_MARKER, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MATH_BLOCK_STYLE_ID, MATH_INLINE_FONT_MARKER, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, TASK_CHECKBOX_CHECKED, TASK_CHECKBOX_UNCHECKED, headingStyleId, parseHeadingStyleId };
+export { CODE_BLOCK_STYLE_ID, HORIZONTAL_RULE_STYLE_ID, HTML_PREFORMATTED_STYLE_ID, MATH_BLOCK_STYLE_ID, MATH_INLINE_FONT_MARKER, MAX_HEADING_STYLE_LEVEL, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID, TASK_CHECKBOX_CHECKED, TASK_CHECKBOX_UNCHECKED, headingStyleId, parseHeadingStyleId };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdown-codec",
-  "version": "4.1.0",
+  "version": "5.0.0",
   "description": "Hand-written CommonMark+GFM <-> DocumentPackage codec, built on document-schema.js",
   "type": "module",
   "repository": {